同一git仓库实现高效多分支并行开发

在同一项目文件夹内，无法直接同时基于两个不同的分支进行开发。这是因为 Git 的工作目录（Working Directory）和暂存区一次只能对应一个检出（checkout）的分支。当你切换分支时，工作区里的文件会立刻变成那个分支的版本——此时如果你修改了文件但未提交，切换行为要么被拒绝，要么会覆盖你未保存的更改（除非强制）。

但 Git 提供了一个非常实用的命令git worktree，可以让你在同一项目仓库中创建多个独立的工作目录，每个目录检出一个不同的分支，真正做到并行开发。

为什么一个文件夹不能并行开发两个分支？

• Git 的.git目录保存了对象库、引用和索引（index），工作区的文件状态由当前HEAD指向的分支决定。
• 如果你在feature/A分支上修改了文件，此时切换到feature/B，Git 会尝试用 B 分支的文件覆盖你修改过的文件，这会带来冲突风险，或者直接阻止你切换。

因此，想同时编辑两个分支的文件，必须拥有两份独立的工作目录。

方案：git worktree实现并行开发

git worktree允许你在同一个 Git 仓库中创建多个附加的工作树（working tree），每个工作树可以检出不同的分支，互不干扰。

步骤演示

假设你正在main分支上，同时需要开发两个功能feature/login和feature/payment。

1. 查看当前工作树

gitworktree list

输出类似：

/path/to/project abc1234 [main]

2. 创建新的工作树并检出分支

# 为 feature/login 创建新目录并切换到该分支gitworktreeadd../project-login feature/login

如果分支feature/login不存在，命令会基于当前提交创建新分支并切换过去。

进入../project-login目录，你会发现这是一份独立的工作目录，里面的文件就是feature/login分支的版本。你可以在这里正常开发、提交。

3. 再创建另一个工作树

gitworktreeadd../project-payment feature/payment

现在你有三个工作目录：

• 原项目目录：main分支
• ../project-login：feature/login分支
• ../project-payment：feature/payment分支

三个目录完全独立，你可以同时打开不同的编辑器或 IDE 窗口，并行修改不同分支的代码，互不影响。

4. 并行开发的工作流程

• 在../project-login中修改代码、git add、git commit。
• 在../project-payment中同样操作。
• 两个分支的修改会被保存到同一个本地仓库（即主项目.git里），你可以在任意工作树中执行git log、git push、git pull等命令，它们共享同一个对象库和引用。

5. 工作完成后，删除工作树

# 先进入主项目目录，然后删除工作树（会自动清除相关元数据）gitworktree remove../project-logingitworktree remove../project-payment

重要注意事项

1. 不能同时检出同一个分支
   一个分支只能在一个工作树中被检出，不能同时在多个工作树里检出（Git 会报错）。

2. 资源开销较小
   虽然每个工作树有自己的文件副本，但 Git 的对象库是共享的（只有一份）。新工作树的创建过程其实是用了硬链接或复制引用，不会把所有历史文件重新拷贝一遍，磁盘占用比完整clone小得多。

3. .git文件变重定向
   在新工作树的根目录下，.git不是一个目录，而是一个文件，里面指向主仓库的.git目录和对应的分支引用。这是正常现象，不要手动修改。

4. IDE/编辑器支持
   用不同的窗口分别打开不同工作树目录即可。VSCode、IntelliJ 等都能很好地识别每个工作树的 Git 状态。

5. 子模块或大文件注意
   如果项目有子模块，每个工作树需要单独初始化和更新子模块。Git LFS 也同样需要注意在每个工作树中执行git lfs pull。

如果你不想用git worktree，还有两个替代方案（但都不够优雅）

• git stash+ 切换分支：每次只开发一个分支，临时切换时把当前修改 stash 暂存，切回来再 pop。适合临时切换，不适合“并行”。
• 完整克隆两份仓库：git clone两次到不同文件夹，然后各自 checkout 不同分支。这虽然简单，但会浪费磁盘空间，并且两个仓库的本地区块是独立的，无法直接共享本地未推送的提交（需要 fetch 或 push 到远程中转）。

总结

git worktree是 Git 官方提供的并行开发利器，特别适合需要频繁在多个特性之间切换、或者一边修紧急 bug 一边继续开发功能而避免stash混乱的场景。你可以现在就试试，把原来的项目作为主工作树，然后用它开辟“平行宇宙”吧。