VSCode本身不支持多分支同时维护的原生能力，必须通过git worktree创建物理隔离的分支文件夹，并用多根工作区聚合管理，才能实现真正的并行开发与调试。
为什么不能直接在同一个工作区里“同时打开多个分支”
VSCode 的资源管理器和编辑器绑定的是**当前打开的文件系统路径**，不是 Git 分支。你 checkout 到 feature/login，所有文件就是那个分支的快照；切到 main，整个工作区内容就替换成 main 的版本。不存在“左边看 feature，右边看 main”这种并行视图。
常见误操作包括：
- 在同一个文件夹下反复
git checkout→ 导致未提交变更丢失、冲突频发、调试断点错位 - 以为开了两个 VS Code 窗口（各自打开同一仓库不同分支）就算“同时维护” → 实际上两个窗口共享同一份
.git和node_modules，极易互相污染 - 依赖插件声称“分支隔离”，结果发现只是加了状态栏提示，底层仍是单工作目录
真正可行的多分支维护方案：用独立文件夹 + 多根工作区
核心思路：每个分支对应一个**物理隔离的文件夹**，避免 Git 状态、依赖、构建产物交叉干扰。VSCode 通过多根工作区把它们聚合起来，统一搜索、跳转、调试。
实操步骤：
- 用
git worktree add ../myrepo-feature-login feature/login创建独立分支工作树（推荐），或手动git clone+git checkout出多个副本 - 确保各分支文件夹命名清晰，如
myrepo-main、myrepo-feature-login、myrepo-hotfix-123 - 新建空 VS Code 窗口 →
Ctrl+Shift+P→ 输入Workspaces: Create Workspace→ 多选上述所有分支文件夹 → 保存为myrepo-branches.code-workspace - 在
.code-workspace中显式写入相对路径："folders": [{"path": "./myrepo-main"}, {"path": "./myrepo-feature-login"}]
这样做的好处是：每个分支有自己完整的 node_modules、dist、Git 索引，互不干扰；而你在 VS Code 里仍能用 Ctrl+Shift+F 跨分支搜索、Ctrl+P 快速定位同名文件、甚至在 launch.json 中为每个分支配独立调试 cwd。
launch.json 和 tasks.json 怎么适配多分支场景
如果你要在不同分支里运行相同逻辑（比如都跑本地开发服务器），但端口、环境变量、构建输出路径不同，就不能只靠自动发现——必须显式绑定分支上下文。
关键点：
-
launch.json必须放在工作区根目录的.vscode/下，不能放某个分支子文件夹里 - 每个
configuration必须设"cwd": "${workspaceFolder:myrepo-feature-login}"，其中myrepo-feature-login要和.code-workspace中对应folders的文件夹名完全一致（注意大小写） - 避免用
"program": "./dist/index.js"这种相对路径——它默认以工作区根为基准，而非当前分支文件夹。应写成"program": "${workspaceFolder:myrepo-feature-login}/dist/index.js" -
tasks.json同理：每个task的"group"和"presentation"可共用，但"command"和"args"中涉及路径或环境的部分，需用${workspaceFolder:name}显式替换
容易被忽略的坑：Git 状态、终端、扩展行为全乱套的根源
很多人做完多分支工作区，却发现 Git 面板只显示一个分支的状态、终端启动总进错目录、ESLint 报错路径错乱——问题几乎都出在作用域没对齐。
根本原因：
- VS Code 的 Git 扩展默认只监听**第一个添加的文件夹**的
.git，其他分支文件夹即使有完整.git目录，也不会被识别为独立仓库 → 解决办法：在.code-workspace中为每个folders条目加上"name": "myrepo-main"字段，并确认各文件夹内确实存在独立.git - 集成终端默认启动位置是「当前活动编辑器所在文件夹」；如果没打开任何文件，它会 fallback 到第一个文件夹 → 解决办法：右键某个分支文件夹 →
Open in Integrated Terminal，或在终端下拉菜单中手动切换 - 像 Prettier、ESLint 这类扩展，会从「当前打开文件的路径向上查找配置文件」；若你在
myrepo-main/src/index.ts编辑，它找的是myrepo-main/.prettierrc，没问题；但若你误开了myrepo-feature-login/src/index.ts却没激活该文件夹标签页，它可能错误复用myrepo-main的配置 → 解决办法：开启设置"workbench.editor.labelFormat": "medium"，让标签页显示相对路径，一眼识别当前上下文
最麻烦的一点是：这些行为不会报错，只会静默错位。等你发现 ESLint 规则没生效、终端 npm run dev 启动的是旧分支服务时，往往已经改了一堆代码。
