docs(readme_en): 修复照做即失败的 Windows 命令与 .env 文件引用 - #117
Open
hailuohl wants to merge 1 commit into
Open
Conversation
hailuohl
force-pushed
the
docs/fix-readme-en-windows-commands
branch
from
September 7, 2026 19:35
ca4a9dd to
83d8783
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
README_EN.md 中有 4 处"照文档操作第一步就失败"的错误:
Windows 命令分隔符错误(原第 189 行):
cmd 不把
;当命令分隔符——整串DEV ; uvicorn ...会被赋值给ENV,uvicorn 根本不会执行。且该行丢失--reload参数(与 macOS/Linux 行不一致)。改为分两行命令并补齐参数。虚拟环境路径与安装流程矛盾(原第 185 行):
venv\Scripts\activate.bat,而同块上一行 macOS/Linux 用的是source .venv/bin/activate——上方步骤uv sync生成的是.venv,Windows 路径应为.venv\Scripts\activate.bat。不存在的
backend/.env.dev.example(原第 132、158 行):仓库中实际文件为backend/.env.example,cp backend/.env.dev.example ...直接报 No such file。不存在的
frontend/.env.example(原第 133、164 行):frontend 下的frontend/.env.development已在仓库中且被跟踪,无需(也无处)复制;改为"直接编辑该文件"。验证
backend/.env.example存在、frontend/.env.development存在、frontend/.env.example不存在、backend/.env.dev.example不存在;set ENV=DEV单独一行)。备注
中文版 README 对应步骤(
.\venv\Scripts\Activate.ps1+ uv sync 并存)的矛盾由另一个 PR(win_start.bat 自动探测 venv/.venv + README 注释)处理,本 PR 只修 README_EN 明确的错误,改动保持最小。