git worktree(Git 工作树)是 Git 自 2.5 版(2015 年)内置的原生能力:让同一个仓库同时拥有多个工作目录,每个目录各挂一个独立分支,互不干扰。过去它主要解决”手上开发还没完、线上又要点热修”的老问题;AI 编码 agent 普及之后,它成了并行 agent 的隔离地基——Orca 这类 ADE 就是直接把 agent 架在 worktree 上。本文上半段把命令行用法和四个高频坑讲透,下半段给出 GUI(图形界面)管理方案和一张选型速查表。
git worktree 是什么:一个仓库,多个工作目录
一个普通仓库只有一套工作目录,切分支就要先收尾手头改动。worktree 把”目录”和”分支”解耦:git worktree add 可以再开一个工作目录挂到另一个分支上,主目录不动,新目录照常编辑、提交、跑测试。
它和多 clone 几份仓库是两回事:
| 对比项 | git worktree | 多 clone 几份 |
|---|---|---|
| 仓库对象库 | 多目录共享同一套 .git 对象库 | 每份各自完整,磁盘翻倍 |
| 提交可见性 | 新目录的提交,主目录立刻可见 | 要 fetch/push 才能同步 |
| 分支占用 | 一个分支同一时刻只挂一个目录 | 各自独立,容易产生分叉 |
| 适用规模 | 两三个到十几个目录 | 大规模隔离才值得 |
命令行三件套:add / list / remove
日常用到的主要就这三条命令:
# 1. 新建:在 ../app-hotfix-pay 目录挂新分支 hotfix/pay
git worktree add ../app-hotfix-pay -b hotfix/pay
# 2. 查看当前仓库所有工作树
git worktree list
# 输出形如:
# /home/me/app 3f2c1a0 [main]
# /home/me/app-hotfix-pay 8b71e55 [hotfix/pay]
# 3. 收工清理:先删目录,再清元数据
git worktree remove ../app-hotfix-pay
git worktree prune # 手动 rm -rf 过目录时,用 prune 清残留记录
三个细节值得记住:
add ../目录 分支名(不带-b)可以把一个已有分支挂到新目录;- 新目录里跑测试、装依赖和普通仓库没有任何区别;
- worktree 目录可以放在仓库外面任意位置,放同级目录(
../)是最常见的习惯。
命令行玩法的四个高频坑
坑 1:fatal: ‘xx’ is already checked out
现象:把一个分支挂到新目录时报错:
git worktree add ../app-pay hotfix/pay
# fatal: 'hotfix/pay' is already checked out at '/home/me/app'
原因:Git 限制一个分支同一时刻只能挂在一个工作目录。解法:新开分支用 -b,或者把旧目录里的分支先切走再挂。
坑 2:新目录里依赖没装
现象:新 worktree 里跑 npm test 报找不到模块。原因:worktree 只共享 Git 对象库,node_modules、venv 这类未跟踪目录不共享。解法:建树后立刻在目标语言生态里装依赖(npm/pnpm、pip、cargo 等),团队里可以沉淀成一条”建树即装”的脚本。
坑 3:手动删目录后 list 里仍有残留
现象:直接 rm -rf 掉了 worktree 目录,git worktree list 还显示它。原因:Git 只在特定操作时清理元数据。解法:跑一次 git worktree prune,残留记录即被清掉。
坑 4:树一多,人肉管理先崩溃
前三个坑都有命令级解法,第四个没有:目录名、分支名、当前任务、跑在里面的 agent,这四张表全靠脑子对齐。两个树还行,五六个树加两三个并行 agent 时,命令行体验就开始崩溃——这是 GUI 方案的入口。
什么时候该上 GUI:三个信号
- worktree 长期保持在 3 个以上,目录与分支的对应关系开始需要”记”;
- 跑在 worktree 里的不是你自己的编辑,而是长任务 agent,需要一眼看清”谁在干什么、跑到哪了”;
- 需要在多台机器(本地 + SSH 远程环境)之间切换工作现场。
三条命中任意两条,就值得换 GUI 管理方案。
用 Orca 管理 worktree:把树变成工作台
Orca(官网 onorca.dev,Stably 公司出品的免费开源 Agent Development Environment,即 ADE,智能体开发环境,MIT 协议,支持 macOS/Windows/Linux,截至 2026-09 官网显示约 5.9 万 GitHub stars)官方对自己的描述里就有”worktree IDE”这个词。它把 worktree 从”命令”升级成”工作台单元”:
- GUI 建、删、切树:点选仓库新建 worktree,目录与分支自动对齐,绕开坑 1;也可以用命令行入口
orca worktree create(完整参数【待补:官方 CLI 文档】); - 每个 worktree 一整套现场:Ghostty 风格终端(WebGL 加速、分屏、完整回滚)、Monaco 内置编辑器、内嵌 Chromium 浏览器,全部按 worktree 组织;
- agent 编排:Claude Code、Codex、OpenCode、Gemini、Cursor CLI、Grok、Copilot 等 CLI agent 挂在各自 worktree 里并行跑,diff 行上写 markdown 批注攒批发回;
- SSH worktree:远程机器上的工作树纳入同一套管理,配合 iOS(App Store + TestFlight)与 Android APK 移动端,出门也能遥控进度。
不依赖 GUI 的等价玩法也存在——手动建树、手动起 agent,Orca 做的就是把这段流程收进一个界面:
# 纯命令行搭一个"双 agent 并行"的最小现场
git worktree add ../app-feat-search -b feat/search
git worktree add ../app-refactor-api -b refactor/api
cd ../app-feat-search && claude # 终端 1:搜索功能 agent
cd ../app-refactor-api && claude # 终端 2:接口重构 agent
树一多,上面这些 cd、目录名、分支名的对应关系就会膨胀成管理负担——这正是 GUI 的价值所在。

(【待补:Orca worktree 管理界面真实截图】)
安装方式见官网【待补:官网实际安装命令与下载方式】,版本【待补:当前最新版本号】;上手路径详见《Orca 上手教程》,agent 并行的完整流程见《用 Orca 同时跑多个 Claude Code》。
选型速查:命令行、多窗口还是 worktree GUI
| 方案 | 适合谁 | 优势 | 局限 |
|---|---|---|---|
| 纯命令行 worktree | Git 熟手,偶尔并行 | 零依赖,Git 2.5+ 即用,可脚本化 | 树多了靠记性,无 agent 编排能力 |
| 编辑器多开窗口 | 已有 IDE 习惯 | 上手零成本 | 窗口不等于隔离,多实例共目录仍会互相覆盖 |
| Orca | 并行 agent 成为日常 | worktree + agent + 终端 + 浏览器一体,三平台,免费开源(MIT,软件本身 0 元) | 多一个常驻桌面应用;需要适应 ADE 工作流 |
一句话结论:并行目录 2 个以内、自己写代码为主,命令行足够;要让多个 agent 长期并行干活、还要跨机器切换现场,直接上 Orca 这类 worktree GUI。
FAQ
git worktree 和再 clone 一份有什么区别?
worktree 的多个目录共享同一套仓库对象库,提交即时互见、磁盘占用小;多 clone 是多份独立仓库,要靠远程同步,还容易产生分叉。短期的多任务并行,worktree 几乎总是更优。
两个 worktree 能挂同一个分支吗?
不能。Git 限制一个分支同一时刻只挂载一个工作目录,重复挂载会报 already checked out。这正是它作为 agent 隔离方案可靠的原因:分支和目录一一对应。
Windows 上能用 git worktree 吗?
能。worktree 自 Git 2.5 起全平台支持,Windows 原生 Git 即可。若要走 agent 并行路线,Orca 也支持 Windows——终端方面,Ghostty 本体没有 Windows 版,Orca 提供的是 Ghostty 风格的同款体验。