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
- 打开 Git 面板——按 Cmd+G
- 点击面板顶部的 Worktrees 标签页
- 点击 + Add Worktree
- 选择一个分支——可以从列表中选择已有分支,也可以输入新的分支名来创建
- 为新的 worktree 选择文件夹位置(默认情况下,1DevTool 会建议在当前项目文件夹旁边创建)
- 点击 Create——1DevTool 会运行
git worktree add,并将新的 worktree 文件夹作为活动工作区打开
新的 worktree 现在会与主 worktree 一起显示在 Worktrees 标签页中。

Worktree 终端
1DevTool 创建 worktree 时,还会打开一个以该 worktree 文件夹为作用范围的新终端。终端标题中会显示分支名,让你随时清楚自己正在哪个分支上工作。
该终端中的 AI agent 在 worktree 文件夹内运行——它可以读写文件、运行命令并在该分支上进行修改,既不会感知其他分支,也不会对其产生干扰。


你可以在多个 worktree 中同时运行 agent。一个 agent 开发 payments 功能,另一个在不同分支上修复 bug。两个 agent 各自拥有自己的终端、文件上下文和分支,因此不会相互冲突。
从状态栏切换 Worktree
当项目有已链接的 worktree 时,状态栏会在分支标签旁显示当前活动的检出名称——包括它的颜色,以及主 worktree、已锁定和有未提交更改的标记——并且无需打开 Git Client 即可在它们之间切换。

以下两点能让切换结果符合你的预期:
- 属于该 worktree 的终端会自动置于前台。 你不会停留在另一个检出的标签页上——这正是命令最容易在错误的目录树中运行的原因。
- 空的 worktree 会明确告诉你。 没有可见终端的检出会显示 No terminal in this worktree 和一个 Add terminal in this worktree 按钮,而不是显示来自其他地方的残留面板。
文件资源管理器也会跟随当前活动的 worktree,因此你浏览的目录树与命令运行所在的目录树保持一致。
删除 Worktree
当你用完某个 worktree——PR 已合并、分支已删除——可以将它干净地移除:
- 打开 Git 面板,进入 Worktrees 标签页
- 找到要删除的 worktree
- 点击它旁边的垃圾桶图标
- 确认删除
这会删除 worktree 文件夹,并在 Git 中取消其注册(相当于 git worktree remove)。分支本身不会被删除——只删除工作目录。需要时你可以稍后重新创建该 worktree。
提示: 使用 worktree 让 AI agent 在功能分支上运行,同时保持 main 稳定。agent 不会意外破坏你的 main 分支。
Worktree 是 Git 中最被低估的功能之一。在 AI 辅助开发的场景中——agent 可能在几分钟内修改几十个文件——能够把每个 agent 的工作隔离到各自的分支和文件夹中,是一道重要的安全保障。