术语表

什么是 Git Worktree？

Git worktree 是代码仓库在独立分支上的另一份副本。它与主仓库共用同一份 git 历史，但文件放在自己的文件夹中。你可以同时打开任意多个 worktree。

worktree 解决了什么问题

通常，一个仓库就是一个文件夹，一次只能检出一个分支。如果你想同时开发两个功能，就得先把修改存进 stash，再切换分支。做完另一项工作后，还得切回来并恢复 stash。很麻烦。

有了 worktree，你会得到第二个文件夹，而且它已经在另一个分支上。一个文件夹开发功能 A，另一个开发功能 B。不用暂存，也不用来回切换。两边可以同时存在。

为什么 AI 智能体需要它

如果两个 AI 智能体在同一个文件夹中运行，它们会覆盖彼此的修改。智能体 A 修改 auth.ts。智能体 B 也修改 auth.ts。最后保存的人赢，另一个智能体的工作会丢失。

Worktree 能解决这个问题。每个智能体都有自己的文件夹、分支和文件副本。它们可以同时修改 auth.ts，不会互相干扰。完成后，你再分别合并每个分支。

磁盘上的目录结构

my-project/              ← your main repo (main branch)
../my-project-feature-a/ ← worktree (feature-a branch)
../my-project-feature-b/ ← worktree (feature-b branch)

三个文件夹共用同一份 git 历史。一个 worktree 中提交的修改，在合并后会出现在其他 worktree 中。但未提交的文件修改完全隔离。

Pane 如何自动管理 worktree

你不用自己运行 git 命令。在 Pane 中创建新 pane 时：

1. Pane 会替你创建 worktree 和分支。
2. 它会复制环境变量、node_modules 和其他重要目录，让智能体马上开始工作。
3. 归档 pane 时，Pane 会自动清理 worktree。

手动操作方式，仅供参考

如果不用 Pane，你需要这样做：

git worktree add ../feature-a feature-a
cd ../feature-a
claude   # start your agent here

# when done:
git worktree remove ../feature-a

Pane 一次点击就能替你完成这些操作。

相关文档

作者 Parsa Khazaeepoul

最后更新于 2026年6月24日