VSCode必须直接打开工作树目录才能识别Git状态；该目录下需有指向主仓库.git/worktrees/的.git文件，且Git版本≥2.25、插件启用多工作树支持、工作树干净才可安全删除。

VSCode 必须打开工作树目录本身，否则 Git 状态不生效

VSCode 不会自动扫描主仓库下的所有 git worktree add 生成的子目录。它只在你**明确用“File → Open Folder…”打开某个工作树路径时**，才加载该目录下的 Git 上下文。

常见错误现象包括：源代码管理视图灰掉、状态栏显示 “No source control providers”、集成终端中执行 git status 报错 fatal: not a git repository。

• 确认该目录下存在一个 .git 文件（不是文件夹），内容应为类似 gitdir: /path/to/repo/.git/worktrees/feature-x
• 不要打开父目录或主仓库根目录——哪怕它看起来“更上层”，VSCode 就认这个物理路径
• 如果用了 GitLens 等插件，检查其设置里是否启用了 multi-worktree support（默认可能关闭）

创建工作树时 -b 参数决定分支是否存在，别漏掉

要不要加 -b，本质是“检出已有分支”还是“新建本地分支”。混淆会导致后续 push 失败、远程追踪丢失，甚至误以为分支已建好。

• 想基于远程分支（如 origin/feature/login）拉取并检出同名本地分支 → 不加 -b：git worktree add ../feature-login feature/login
• 想新建一个本地分支（比如 feature/new-ui）并立即在新目录中检出 → 必须加 -b：git worktree add -b feature/new-ui ../feature-new-ui main
• 想临时调试某次提交 → 加 --detach：git worktree add --detach ../debug-e7f3d2a e7f3d2a

漏掉 -b 后，git branch 里找不到该分支，git push 会提示 “no upstream configured”，得补一句 git push -u origin feature/new-ui 才能建立追踪。

Convert Github Repository

适用于以下场景：（1）用户提供 GitHub 仓库 URL 或本地仓库路径，并请求将其转换为其他格式；（2）用户请求导出 GitHub 仓库……

下载

多个 VSCode 窗口并行运行不同工作树，完全隔离无冲突

每个工作树有独立的 index、HEAD、工作目录和 node_modules（或 venv）。VSCode 启动时只读当前打开路径的 .git 引用，不会跨目录干扰。

• 你在 feature/auth 窗口改了 package.json 并 npm install，不影响 hotfix/login 窗口的依赖状态
• 可同时运行 npm run dev 和 npm test，它们分别基于不同分支的代码快照
• 状态栏右下角会清晰显示当前窗口的分支名 + 工作树路径，比如 feature/auth | /path/to/repo-feature-auth

删除工作树前必须确保干净，否则 git worktree remove 拒绝执行

git worktree remove 默认拒绝删除含未提交更改或未推送提交的工作树，这是保护机制，不是 bug。

• 先检查该工作树目录下是否有未提交修改：git status --porcelain，输出为空才安全
• 若有修改但不想丢，可先 git add . && git commit -m "temp"，再删
• 真要强制删（比如调试完的临时工作树），用 git worktree remove --force ../feature-debug，但务必确认没遗漏重要改动
• 注意：--force 只删关联记录，目录本身仍留在磁盘上，需手动 rm -rf

最容易被忽略的是：VSCode 窗口开着时直接删工作树，Git 会报错且可能留下残留锁文件；务必先关掉对应窗口，再执行删除命令。