摘要：AI 写代码太快，合并和切换分支成了瓶颈？本文通过真实项目案例（抖音视频提取工具），手把手教你利用 Git Worktree 构建“多 AI 并行开发”工作流。告别频繁的 git stash，让多个 AI Agent 在同一仓库下互不干扰地同时推进功能，实现开发效率的指数级跃升。

---

🚀 引言：当 AI 速度超越了 Git 流程

你是否遇到过这种尴尬场景：
AI 1 正在帮你重构后端接口，突然你有了灵感，想让 AI 2 去搞定前端 UI。
但此时，你的 Git 工作区全是 AI 1 修改了一半的代码。
怎么办？

• 痛苦选项 A：git stash 暂存 -> 切分支 -> 让 AI 2 干活 -> 切回来 -> git stash pop -> 处理冲突…（心累）
• 痛苦选项 B：重新 git clone 一个新仓库…（浪费磁盘，配置还得重搞）

现在，有了终极解法：Git Worktree。

它就像是给你的代码仓库开了“影分身”，允许你在同一台机器、同一个仓库下，同时拥有多个完全独立的工作目录。

---

📚 核心理念：Worktree + 分支 = 完美并行

要驾驭多 AI 开发，必须厘清两个概念的区别：

1. 分支 (Branch) = 逻辑边界：定义“我们在开发什么功能”。
2. Worktree (工作树) = 物理边界：定义“我们在哪里开发”。

🛠️ 多 AI 标准作战地图

在我们的架构中，每一个 AI Agent 都应该拥有自己专属的“物理工位”（Worktree）和“任务目标”（Branch）。

• 🤖 AI 1 (CLI 专家)：

• 地盘: D:/project/douyin_cli (Worktree)

• 任务: feature/cli-enhancement (Branch)

• 🤖 AI 2 (Web 专家)：

• 地盘: D:/project/douyin_web (Worktree)

• 任务: feature/web-ui (Branch)

• 👨‍💻 你 (指挥官/集成者)：

• 地盘: D:/project/douyin_main (主 Worktree)

• 任务: main (负责 Code Review 和 Merge)

---

⚔️ 传统 VS Worktree：效率对比

维度	🐢 传统方式 (单 Worktree)	🚀 Worktree 方式 (多 AI 并行)
并行能力	伪并行：同一时间只能处理一个任务	真并行：物理隔离，同时运行
上下文切换	繁琐：依赖 stash/pop，容易丢代码	丝滑：直接 cd 目录，毫秒级切换
环境隔离	差：依赖包容易混杂，测试互相影响	完美：每个目录可运行独立的 Dev Server
适用场景	单人线性开发	人+AI 协作、多 AI 赛马

---

💻 实战演练：重构“抖音视频提取工具”

项目背景：我们有一个 Python CLI 工具，现在需要同时做两件事：

1. 优化 CLI 的正则匹配（AI 1 负责）。
2. 开发一个基于 Flask 的 Web 界面（AI 2 负责）。

第一步：指挥官建立“基地” (Create)

作为集成者，你首先要为 AI 们开辟独立的工作空间。

# 进入主仓库
cd D:\code\douyin_practice

# 1. 为 AI 1 创建空间（开发 CLI）
# 语法：git worktree add <新目录路径> -b <新分支名>
git worktree add ../douyin_practice_cli -b feature/cli-optim

# 2. 为 AI 2 创建空间（开发 Web）
git worktree add ../douyin_practice_web -b feature/web-ui

# 查看当前战况
git worktree list
# 输出：
# D:/.../douyin_practice      [main]
# D:/.../douyin_practice_cli  [feature/cli-optim]
# D:/.../douyin_practice_web  [feature/web-ui]

第二步：AI 并行开发 (Develop)

此时，你的磁盘上出现了三个文件夹。它们共享同一个 .git 历史，但文件状态完全独立！

场景 A：AI 2 开发 Web 界面

cd ../douyin_practice_web
# 安装 Flask
uv add flask
# 创建 web_app.py...
# 启动测试服务
python web_app.py
# (服务运行在 localhost:5000)

场景 B：AI 1 同时在优化 CLI

cd ../douyin_practice_cli
# 修复正则 Bug...
# 运行 CLI 测试
python main.py extract "https://v.douyin.com/xxx"
# (完全不受 Web 端依赖的影响)

第三步：指挥官验收与合并 (Merge)

当 AI 们都完成了任务，你只需要坐在主工作区进行验收。

# 回到主基地
cd ../douyin_practice

# 1. 检查各路进度
git log --all --graph --oneline

# 2. 合并 AI 2 的 Web 功能
git merge feature/web-ui --no-ff -m "feat: 集成 Web 界面"

# 3. 处理依赖冲突 (如果 pyproject.toml 有冲突)
# 手动保留双方需要的库 -> uv lock -> git add . -> git commit

# 4. 验证
ls -R
# 此时主分支既有了 CLI 的优化，也有了 Web 的代码

第四步：打扫战场 (Cleanup)

任务完成后，及时清理不再需要的 Worktree，保持清爽。

# 删除 worktree 目录（物理删除）
git worktree remove ../douyin_practice_web

# 删除对应的功能分支（逻辑删除，可选）
git branch -d feature/web-ui

---

💡 避坑指南 & 最佳实践

1. 命名规范是关键

不要用 temp1, work2 这种名字。推荐采用 项目名-功能名 的格式：

• ✅ project-web-ui
• ✅ project-hotfix-login
  这样你在终端 ls 时，一眼就能看出哪个目录是干什么的。

2. 依赖管理的注意事项

虽然 Worktree 隔离了代码，但如果你的虚拟环境（venv/.venv）是放在项目根目录下的，可能会有干扰。

• 推荐：使用 uv 或 poetry 等现代工具，或者确保每个 Worktree 能够识别其专属的虚拟环境。
• 或者：在 .gitignore 中忽略 .venv，并在每个 Worktree 中单独创建环境。

3. 不要手动 rm -rf

千万不要直接在文件管理器里删除 Worktree 的文件夹！这会导致主仓库的 .git 记录残留无效引用。

• ❌ rm -rf ../project-web
• ✅ git worktree remove ../project-web
  (如果不小心删了，运行 git worktree prune 来清理僵尸记录)

---

📝 总结

Git Worktree 不是什么新奇的黑科技，但在这个 AI 辅助编程 爆发的时代，它的价值被重新放大了。

它完美契合了 “Human-in-the-loop” (人在环路) 的开发模式：

• 你 是架构师和合并者，坐镇主 Worktree。
• AI 是执行者，分散在各个 Feature Worktree 中并行冲锋。

下次当你想让 AI “顺便试一下” 某个新功能时，别再犹豫切分支了，直接 git worktree add，给它开个平行宇宙吧！

---

如果你觉得这篇文章对你有帮助，欢迎点赞、收藏、关注！你的支持是我持续分享 AI 开发技巧的动力。