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 才能建立追踪。
多个 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 会报错且可能留下残留锁文件；务必先关掉对应窗口，再执行删除命令。
