2
0
0

别再 git stash 了:用 Git Worktree 让多个 AI 同时写代码

2026-11-05
2026-11-05
文章摘要
|

AI 干活的时候,你的工作目录就是它的战场

现在的 AI 编码智能体(Claude Code、Codex 这类命令行 agent)越来越能扛活,丢给它一个任务能连续干十几分钟。但有个现实问题很快会浮出来:agent 跑起来的时候,你的工作目录就是它的战场——文件被它改着,你不敢动;临时想修另一个 bug?只能 git stash 把现场存起来,切完分支再 stash pop 回来,一不留神就是一场冲突惨剧。

想同时跑两个 agent 更糟:它们改的是同一个目录,A 刚写完的文件被 B 覆盖,最后谁也干不干净。

解法其实是 Git 十年前就内置的原生功能:git worktree。B站讲 Claude Code 并行开发的 UP 主、知乎和 CSDN 近两个月的讨论帖,最后都收敛到它身上;GitHub 上还冲出来一个专门管理 worktree 的 Rust 工具 Worktrunk,2025 年 10 月开源,一年攒了 1.1 万 star,今天还在 trending 榜上单日再涨 500 多——「并行跑 AI」这个需求有多真实,看这个曲线就知道了。

这篇把原生 worktree 用法和 Worktrunk 上手一次讲透。所有 git 命令和输出都是我在 git 2.47 环境里实际跑出来的,可以直接抄走用。

git worktree 是什么:一个仓库,N 个互不干扰的目录

官方文档的定义很直白:一个仓库有一个主工作目录(main worktree,就是你现在 git clone 下来的那个),再加上零个或多个链接工作目录(linked worktrees)。每个工作目录各自检出不同分支,文件系统层面完全独立,但底层共享同一份 .git 对象库和全部历史。

它和「再 clone 一份仓库」有什么区别?这是最容易搞混的点,直接上对比:

  • 速度:clone 要把全部历史重新下载/复制一遍,worktree 只是在磁盘上铺一份工作文件,秒级完成;
  • 共享:worktree 和主目录共享分支、tag、stash、配置,你在 A 目录 fetch 的最新提交,B 目录立刻能用;
  • 磁盘:只多占一份工作文件的体积,不会多一份 .git(对大仓库来说这点最香)。

一句话:branch 让你「换一套代码状态」,worktree 让你「多一套工作现场」。并行开发要的恰恰是后者——每个 agent 一个现场,谁也别踩谁。

原生三连:add / list / remove

我建了个测试仓库实测(git 2.47.3),从 main 拉一个新分支到新目录,一条命令:

git worktree add ../repo.feature-auth -b feature-auth
# 实测输出:
# Preparing worktree (new branch 'feature-auth')
# HEAD is now at 8a05ae4 init

顺手记一个官方文档里的小知识:最简形式 git worktree add <path> 连 -b 都可以省——它会自动用路径的最后一段当分支名。查看所有工作目录:

git worktree list
# 实测输出:
# /tmp/wt-demo/main-repo          8a05ae4 [main]
# /tmp/wt-demo/repo.feature-auth  8a05ae4 [feature-auth]

cd ../repo.feature-auth 进去,文件齐全、分支已切好,直接开工。两个容易踩的坑我也实测了:

坑一:同一个分支不能同时检出两个工作目录。Git 会直接拒绝,除非加 --force(但基本没理由这么干):

git worktree add ../repo.dupe feature-auth
# fatal: 'feature-auth' is already used by worktree at '/tmp/wt-demo/repo.feature-auth'

坑二:remove 只删目录,不删分支。收尾时是两步操作;如果目录被你手动 rm 掉了,git worktree list 里会留下「失踪记录」,需要 git worktree prune 清理:

git worktree remove ../repo.feature-auth   # 目录删了
git branch                                  # feature-auth 分支还在
git branch -d feature-auth                  # 分支要单独删

手动并行实战:两个 AI 同时开工

原生命令已经够打一套并行组合拳了,开两个终端:

cd ~/code/myproject
git worktree add ../myproject.auth  -b feature-auth
git worktree add ../myproject.tests -b feature-tests

# 终端 1:让 agent 写鉴权
cd ../myproject.auth
claude "实现登录鉴权模块"

# 终端 2:让另一个 agent 补测试
cd ../myproject.tests
claude "给现有 API 补齐单元测试"

两个 agent 各改各的目录,互不知晓也互不干扰。各自干完,回主目录把分支 merge 进 main,收工。

但真用一周你就会烦:每次 add 要手打一遍目录路径,切过去还要 cd,收尾 remove 完还得记得删分支。Worktrunk 的 README 吐槽得很精准——开个新 worktree,分支名要打三遍(git worktree add -b feat ../repo.feat,然后 cd ../repo.feat)。这还是单个 worktree 的成本,五个并行就是十五遍。

Worktrunk:把 worktree 用得像切分支一样顺

Worktrunk 是个 Rust 写的 CLI,定位非常专注:给并行 AI agent 管理工作目录。项目 2025 年 10 月开源,MIT / Apache-2.0 双许可,一年时间成为 star 数最高的 git worktree 管理器。安装:

# macOS / Linux(Homebrew)
brew install worktrunk && wt config shell install

# 或者用 cargo
cargo install worktrunk && wt config shell install

后面那步 wt config shell install 是装 shell 集成,让 wt switch 能真正帮你切目录,不能省。(Windows 用户注意:命令 wt 和系统自带的 Windows Terminal 撞名,官方安装器会自动装成 git-wt。)

核心四连,对照着原生命令看效率差距:

# 建分支 + 建 worktree + 切过去,一条命令
wt switch --create feature-auth

# 看全部工作目录:哪个有改动、领先 main 几个提交、有没有没 push 的
wt list

# 合回 main:生成提交信息、rebase、快进合并、清理一条龙
wt merge main

# 收尾:worktree 和分支一起清掉
wt remove

其中 wt list 的信息量是原生 git worktree list(只给路径)比不了的:每行一个工作目录,@ 标当前所在,+ 表示有暂存改动,↑1 表示领先 main 一个提交,⇡ 表示有未 push 的提交——五个并行任务的状态一眼扫完。

而它真正的主场是并行起 agent。-x 表示切过去之后执行一条命令,-- 后面的参数原样传给它:

wt switch -x claude -c feature-a -- 'Add user authentication'
wt switch -x claude -c feature-b -- 'Fix the pagination bug'
wt switch -x claude -c feature-c -- 'Write tests for the API'

三条命令下去,三个分支、三个目录、三个 agent,同时开工。这是 Worktrunk README 里的招牌用法,也是最贴合当下 AI 辅助开发节奏的姿势——你从「等一个 agent 干完」变成「当五个 agent 的项目经理」。

值得知道的进阶特性

  • hooks:post-start 钩子能在新 worktree 建好后自动装依赖(npm install / uv sync)、起 dev server,agent 一进来就能干活,不用自己摸黑配置;
  • LLM 提交信息:wt 可以直接从 diff 生成 commit message,不用每个目录手写一遍;
  • 共享构建缓存:在 APFS / btrfs / XFS 文件系统上用 copy-on-write,十个 worktree 共享一份 node_modules/、target/——不用每个目录重装依赖,磁盘和时间双重救赎;
  • wt switch pr:123:直接检出某个 PR 的分支,review 别人代码不用再翻半天远端分支名;
  • hash_port 模板变量:给每个 worktree 分配固定独立端口,多个 dev server 并存不打架。

总结

git worktree 是 Git 原生功能,两条命令就能让多个 AI 智能体真正并行干活,零额外依赖,这是当下成本最低的「多开」方案;Worktrunk 在这之上把建目录、看状态、合并、清理全部压缩成一两条命令,如果你日常要同时开三个以上 agent,装一个当天回本。

三个最适合上手的场景:

  • 同时给多个 AI agent 派活,各占一个目录互不干扰;
  • agent 跑长任务时,自己切到另一个目录继续写代码,不用干等;
  • 同一项目开两个分支对拍调试——一个复现 bug、一个验证修复,来回切换零成本。

下次手指头已经敲到 git stash 的时候,试试 git worktree add,你会回来谢我的。

以上内容为 GLM 5.3 Agent 整合定时发布。

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或者给予支持!

别再 git stash 了:用 Git Worktree 让多个 AI 同时写代码
/archives/tech-blog-2026-11-05
作者
番茄酱唉
发布于
2026-11-05
许可协议
CC BY-NC-SA 4.0

评论

欢迎来到我的博客!