VSCode默认不自动检测子目录Git仓库是因为git.autoRepositoryDetection默认为true但仅扫描一级子目录；设为"always"可递归检测，需确保.git为非裸库且配置写在用户或工作区设置中。
VSCode 为什么默认不自动检测子目录里的 Git 仓库
因为 VSCode 的 Git 扩展默认只扫描工作区根目录（即你用 code . 打开的那个文件夹）下的 .git，不会递归搜索子目录。这不是 bug，是设计选择——避免大型项目里成百上千个子模块触发 Git 状态轮询，拖慢编辑器响应。
常见错误现象：Git: Repository not found 提示出现在子目录里打开的文件上；源代码管理侧边栏空着，但你知道那里明明有个独立的 .git；git status 在终端能跑，VSCode 就不认。
- 必须手动在子目录里右键 → “Reopen Folder”，才能让 Git 扩展加载它
- 如果用多根工作区（multi-root workspace），每个根目录需单独包含
.git，否则子目录仍被忽略 -
"git.autoRepositoryDetection"默认为true，但它只对「一级子目录」生效（即工作区根下的直接子文件夹），再深层就不管了
开启深度自动检测：改 git.autoRepositoryDetection
这个配置项控制 VSCode 是否主动扫描子目录找 .git。设为 true 是默认行为，但只扫一层；设为 "submodules" 会额外识别 Git 子模块；设为 false 则完全关闭——都不是我们想要的。
真正起效的是把它设为 "always"：
"git.autoRepositoryDetection": "always"
这样 VSCode 会递归扫描整个工作区（包括嵌套多层的子目录），只要发现 .git 就尝试初始化仓库状态。
- 性能影响：大型单体仓库（比如含几十个独立
.git的 monorepo）可能轻微卡顿，尤其首次加载时 - 兼容性：VSCode 1.76+ 支持该值，旧版本设了也无效
- 注意不是布尔值，写成
true或"true"都不行，必须是字符串"always"
子目录 Git 仓库没反应？检查 .git 是否是裸仓库或符号链接
VSCode 的 Git 扩展只支持标准工作树结构。如果子目录里的 .git 是个裸仓库（bare repo），或者指向别处的符号链接（symlink），它会静默跳过。
验证方式：进那个子目录，运行 git rev-parse --is-bare-repository，输出 true 就是裸仓库，VSCode 不支持；用 ls -la .git 看是否为 -> 指向外部路径。
- 裸仓库必须转成普通仓库：用
git clone --no-hardlinks /path/to/bare.git新建一个工作树 - 符号链接需确保目标路径可访问，且不在 VSCode 工作区之外（跨磁盘或网络路径大概率失败）
- 某些 IDE 插件（如 GitLens）会绕过这个限制，但原生 Git 扩展不会
多根工作区下，每个根目录仍需独立 Git 状态
如果你用 code folder1 folder2 启动多根工作区，VSCode 会把 folder1 和 folder2 当作两个并列根，各自检查自己的 .git。但如果你只打开 folder1，然后期望它自动包含 folder1/subproject/.git，那就得靠上面的 "always" 配置。
- 多根工作区不能替代深度检测：即使
folder1/subproject是另一个根，它里面的subproject/nested/.git还是需要"always"才能识别 - 配置要写在用户设置（User Settings）或工作区设置（Workspace Settings）里，不要写在文件夹级
.vscode/settings.json中——后者只对当前文件夹生效，不递归 - 改完配置后不用重启 VSCode，但已打开的文件可能需要手动触发一次
Git: Refresh（Ctrl+Shift+P → 输入该命令）
.git 的存在形式和配置值的字符串类型——写错一个引号或拼写，VSCode 就当没这回事，连报错都不给。 
