Field Note
不要在错误目录初始化 Git 仓库
Git 仓库应该初始化在项目根目录,而不是随手在用户目录或子目录里执行 git init。目录错了,后面所有文件的版本管理都会跟着错。
一句话结论
Git 仓库的位置决定了哪些文件和目录会被纳入版本管理。在错误目录执行 git init,不是小事——它会影响 README、docs、前端应用、部署配置和后续所有协作。执行前先 pwd 或 cd 到项目根目录,确认 README 和 .gitignore 已准备好,然后再 git init。一次确认,省掉后面很多混乱。
这个坑为什么常见
很多人第一次给项目做 Git 初始化时,习惯在当前终端所在目录直接执行 git init,而没有先检查自己到底在哪个目录。常见错误包括:在 C:UsersAS 的用户目录里执行 git init,把整个用户目录当成项目根目录;或者只在 apps/web 里初始化仓库,导致根目录的 README、AGENTS.md、PROJECT_STATUS.md 和 docs 没有被纳入版本管理。造物栈的项目根目录是 C:ZaowuZhan,前端应用在 apps/web。
它会造成什么后果
在错误目录初始化 Git 仓库的三个后果:第一,版本管理范围错误——你本应管理整个项目,但仓库只包含了一个子目录,根目录的关键文档被遗漏;第二,部署平台取错路径——如果部署平台连接的是一个只有 apps/web 的仓库,它找不到项目级别的 README 和配置说明;第三,后续修复成本高——重新在正确目录初始化意味着之前的提交历史可能丢失,需要重新整理。
更稳的做法
更稳的做法:先 cd 到项目根目录(造物栈是 C:ZaowuZhan),然后 pwd 或 echo %cd% 确认当前目录正确。检查 README、AGENTS.md、PROJECT_STATUS.md 和 .gitignore 是否已在根目录。确认无误后再执行 git init。不要在 apps/web 里单独初始化仓库——如果你确实只需要管理前端应用,那也应该在清楚知道后果的前提下做决定。