Git Worktrees

无需 stash 即可同时处理多个分支——每个分支位于各自的文件夹中,并可从状态栏一键切换。

Worktree 解决了日常开发中最令人头疼的问题之一:正在做某件事时,却需要切换分支。使用 worktree,你不必切换分支——只需在另一个文件夹中打开另一个分支,就能同时在两个分支上工作。

什么是 Git Worktree?

通常情况下,一个 Git 仓库只有一个工作目录——也就是存放文件的文件夹。任何时刻,该文件夹中都只会检出一个分支。如果想查看另一个分支,就必须检出它,这会把你的文件替换成该分支的版本。如果当前的工作还没有提交,就得先 stash,既麻烦又容易出错。

Worktree 是链接到同一个 Git 仓库的第二个(或第三个、第四个)工作目录。每个 worktree 都有自己检出的分支、自己的文件状态和自己的历史记录。它们共享同一个 .git 文件夹和提交历史——只是同一个仓库的不同“窗口”。

举个具体的例子:你的 AI agent 正在 feature/payments 上构建新功能,做到一半时,同事请你评审他们在 fix/login-bug 上的 PR。你不必 stash 功能开发中的改动,而是为 fix/login-bug 在另一个文件夹中创建一个 worktree。你在那里评审 PR,而功能分支则原封不动地留在原来的文件夹中。

创建 Worktree

  1. 打开 Git 面板——按 Cmd+G
  2. 点击面板顶部的 Worktrees 标签页
  3. 点击 + Add Worktree
  4. 选择一个分支——可以从列表中选择已有分支,也可以输入新的分支名来创建
  5. 为新的 worktree 选择文件夹位置(默认情况下,1DevTool 会建议在当前项目文件夹旁边创建)
  6. 点击 Create——1DevTool 会运行 git worktree add,并将新的 worktree 文件夹作为活动工作区打开

新的 worktree 现在会与主 worktree 一起显示在 Worktrees 标签页中。

Git worktree

Worktree 终端

1DevTool 创建 worktree 时,还会打开一个以该 worktree 文件夹为作用范围的新终端。终端标题中会显示分支名,让你随时清楚自己正在哪个分支上工作。

该终端中的 AI agent 在 worktree 文件夹内运行——它可以读写文件、运行命令并在该分支上进行修改,既不会感知其他分支,也不会对其产生干扰。

为 git worktree 添加终端

带有分支名的 Git worktree 终端

你可以在多个 worktree 中同时运行 agent。一个 agent 开发 payments 功能,另一个在不同分支上修复 bug。两个 agent 各自拥有自己的终端、文件上下文和分支,因此不会相互冲突。

从状态栏切换 Worktree

当项目有已链接的 worktree 时,状态栏会在分支标签旁显示当前活动的检出名称——包括它的颜色,以及主 worktree、已锁定和有未提交更改的标记——并且无需打开 Git Client 即可在它们之间切换。

状态栏 worktree 选择器:显示“此 worktree 中没有终端”的空状态,文件资源管理器已限定在该检出范围内

以下两点能让切换结果符合你的预期:

  • 属于该 worktree 的终端会自动置于前台。 你不会停留在另一个检出的标签页上——这正是命令最容易在错误的目录树中运行的原因。
  • 空的 worktree 会明确告诉你。 没有可见终端的检出会显示 No terminal in this worktree 和一个 Add terminal in this worktree 按钮,而不是显示来自其他地方的残留面板。

文件资源管理器也会跟随当前活动的 worktree,因此你浏览的目录树与命令运行所在的目录树保持一致。

删除 Worktree

当你用完某个 worktree——PR 已合并、分支已删除——可以将它干净地移除:

  1. 打开 Git 面板,进入 Worktrees 标签页
  2. 找到要删除的 worktree
  3. 点击它旁边的垃圾桶图标
  4. 确认删除

这会删除 worktree 文件夹,并在 Git 中取消其注册(相当于 git worktree remove)。分支本身不会被删除——只删除工作目录。需要时你可以稍后重新创建该 worktree。

提示: 使用 worktree 让 AI agent 在功能分支上运行,同时保持 main 稳定。agent 不会意外破坏你的 main 分支。

Worktree 是 Git 中最被低估的功能之一。在 AI 辅助开发的场景中——agent 可能在几分钟内修改几十个文件——能够把每个 agent 的工作隔离到各自的分支和文件夹中,是一道重要的安全保障。