VS Code Git工作树，多分支并行开发体验，新版VS Code支持通过Git工作树同时检出多个分支，无需频繁切换即可并行开发；本文分享一些多分支协同开发配置方案
目录
一、 核心概念：为什么使用 Worktree？
二、 实战配置：如何快速建立多工作树环境
三、 极致开发体验的配置方案
1. 颜色标记（防止晕头转向）
2. 多窗口/多工作空间管理
3. 插件推荐：GitLens (核心必备)
4. .gitignore 与配置文件共享
四、 协同开发中的“避坑”指南
五、 进阶：自动化脚本
六、总结
如果您喜欢此文章，请收藏、点赞、评论，谢谢，祝您快乐每一天。
VS Code 的Git Worktree（工作树）特性是多分支并行开发的“神器”。传统的 Git 模式下，我们要切换分支（git checkout）必须先提交或暂存当前代码，这不仅打断思路，还容易造成环境污染。
Git Worktree 允许你在同一个 Git 仓库目录下，在不同的文件夹中同时检出多个分支。VS Code 最近的版本对这一特性的支持越来越好，配合一些插件和配置，可以极大地提升开发效率。
以下是实现多分支协同开发的高效配置方案：
一、 核心概念：为什么使用 Worktree？
当你需要：
- 在开发新功能的同时，紧急修复生产环境的 Bug。
- 进行 Code Review 时，查看多个分支的代码差异。
- 对比不同分支的运行效果。……此时 Worktree 是你的最优解。
二、 实战配置：如何快速建立多工作树环境
虽然 VS Code 提供了界面入口，但建议在 Terminal 中通过简单的命令建立基础，VS Code 会自动感知。
1. 创建新的工作树（并行分支）：
# 在当前仓库目录外，创建一个名为 'hotfix-dir' 的文件夹，检出 'hotfix' 分支
git worktree add ../hotfix-dir hotfix
2. VS Code 自动接管：VS Code 识别到目录下有.git引用后，会将其视为独立的 Workspace。你只需在 VS Code 中点击“File > Add Folder to Workspace”，将新创建的../hotfix-dir添加进来。
三、 极致开发体验的配置方案
为了让多分支协同更顺畅，建议进行以下优化：
1. 颜色标记（防止晕头转向）
在同时打开多个工作树时，很容易在不经意间改错了分支的代码。
- 配置方案：使用
Peacock插件。 - 操作：为不同的工作树目录设置不同的颜色。例如，
main分支目录设置为蓝色，hotfix分支设置为红色，feature分支设置为绿色。这样一眼就能看出当前修改的是哪个分支。
2. 多窗口/多工作空间管理
- 推荐操作：将不同的 Worktree 保存为 VS Code 的Workspaces (
.code-workspace文件)。- 你可以创建
main.code-workspace和feature-x.code-workspace，通过快捷键Ctrl+R(或Cmd+R) 快速在不同工作树之间切换。
- 你可以创建
3. 插件推荐：GitLens(核心必备)
GitLens 对 Worktree 的支持非常友好。
- 功能亮点：它能让你在编辑器侧边栏清晰地看到当前文件处于哪个分支。在多 Worktree 环境下，GitLens 的“分支比较”功能可以让你直接跨分支对比代码差异，无需手动执行
git diff。
4..gitignore与配置文件共享
- 避坑：很多本地配置（如
.vscode/settings.json）会被同步。建议在.gitignore中加入.vscode/，或者为不同的分支配置独立的本地配置，以避免不同分支间运行环境（如端口、调试参数）的冲突。
四、 协同开发中的“避坑”指南
1. 清理工作树：用完的分支必须记得清理，否则 Git 仓库会变得极其臃肿。
# 删除工作树
git worktree remove ../hotfix-dir
2. 不要在不同工作树操作同一个子模块 (Submodule)：如果你的项目用了 Git Submodules，在多 Worktree 间操作它们可能会导致引用混乱，尽量在单个 Worktree 中完成子模块更新。
3. 注意全局配置影响：某些全局 Git 配置（如hooks）可能会作用于所有 Worktree。如果你在hooks里写了自动格式化脚本，请确保它兼容不同分支的逻辑。
五、 进阶：自动化脚本
为了简化操作，你可以将创建 Worktree 的命令写成 shell 脚本，放入项目的scripts/目录下：
# create_worktree.sh
#!/bin/bash
BRANCH_NAME=$1
DIR_NAME="../worktree-$BRANCH_NAME"
git worktree add $DIR_NAME $BRANCH_NAME
code --add $DIR_NAME
六、总结
VS Code + Git Worktree = 真正的并行开发自由。
通过“Peacock 颜色隔离 + GitLens 可视化 + Workspace 多开”的组合拳，你再也不需要频繁执行git stash和git checkout。这种模式尤其适合那种“还没改完功能，老板让你立刻修个 Bug”的真实办公场景，能让你的上下文切换成本降到近乎为零。
如果您喜欢此文章，请收藏、点赞、评论，谢谢，祝您快乐每一天。