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 worktree 管理界面真实截图】)

安装方式见官网【待补:官网实际安装命令与下载方式】,版本【待补:当前最新版本号】;上手路径详见《Orca 上手教程》,agent 并行的完整流程见《用 Orca 同时跑多个 Claude Code》。

选型速查:命令行、多窗口还是 worktree GUI

方案适合谁优势局限
纯命令行 worktreeGit 熟手,偶尔并行零依赖,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 风格的同款体验。

相关阅读