git worktree add 完全指南：告别 stash，拥抱并行开发
git worktree add 让你从同一个仓库同时开多个工作目录，彻底解决频繁切换分支的痛苦。本文讲清楚怎么用。
git worktree add 完全指南：告别 stash，拥抱并行开发
你有没有遇到过这种情况：正在 feature 分支上写到一半，突然 PM 说线上有个 critical bug 要立刻修——你只能 git stash，切到 main，改完再切回来，还要 git stash pop，祈祷没有冲突。
git worktree 就是为了解决这个"stash 陷阱"而生的。一个命令，让你同时维护多个工作目录，共享同一份仓库历史，互不干扰。
什么是 git worktree
Git 2.5（2015年7月29日发布）正式引入了 git worktree 功能。在此之前，开发者如果想并行处理多个分支，要么克隆整个仓库，要么依赖一个叫 contrib/workdir/git-new-workdir 的脚本——那个脚本用 symlink 实现，既脆弱又不可移植。
新的 git worktree 机制改用内部指针系统，让多个工作目录安全地共享同一套 Git 对象和引用，不需要重复存储任何数据。
git worktree add 基本用法
核心命令格式：
git worktree add <路径> <分支>
举个例子：你在 feature/payment 分支开发，需要临时修一个 hotfix：
# 新建一个工作目录，检出 main 分支
git worktree add ../hotfix-workspace main
# 进去干活
cd ../hotfix-workspace
# 改代码、测试、commit、push
cd -
# 搞定后清理
git worktree remove ../hotfix-workspace
原来的 feature/payment 工作目录完全没动过——不需要 stash，不需要切换，两边同时开着完全没问题。
常用选项
新建分支并创建 worktree：
git worktree add -b hotfix/auth-bug ../hotfix-workspace origin/main
以 detached HEAD 状态检出特定 commit（AI agent 常用）：
git worktree add --detach ../agent-workspace abc1234
查看所有 worktree：
git worktree list
删除 worktree：
git worktree remove ../hotfix-workspace
# 或者强制删除（有未提交改动时）
git worktree remove --force ../hotfix-workspace
为什么 AI 时代让 git worktree 重新火了
git worktree 存在十年，却一直是"冷门命令"。真正让它进入主流视野的，是 agentic coding（智能体编程）的兴起。
以 OpenAI Codex 为代表的 AI 编程平台，需要同时运行多个自主编码 agent，每个 agent 处理不同的任务。如果每个 agent 都 clone 一份仓库，存储和网络开销巨大；用 git worktree 则优雅得多——所有 agent 共享同一份 Git 历史，每个 agent 在自己的 worktree 里以 detached HEAD 状态独立工作，互不冲突。
这也解释了为什么 JetBrains、VS Code 等主流 IDE 都已原生支持 git worktree——工具链在跟上 AI 工作流的节奏。
关于如何把 AI agent 与 Git 工作流结合，可以参考 Claude Code 不只是编程工具 这篇分析。
需要注意的坑
同一个分支只能被一个 worktree 检出。 如果你在 main worktree 已经检出了 feature/x，再想在另一个 worktree 检出同一个分支会报错。解决方案：新建一个跟踪分支，或用 detached HEAD。
AI agent 规模化时的资源问题。 同时跑大量 worktree 会带来新的边缘情况：资源泄漏、分支锁冲突（.git/refs 下的 lock 文件）。需要在工作流层面做好清理机制，避免僵尸 worktree 堆积。
submodule 支持历史上有限制。 早期版本对 submodule 的支持是实验性的，现代 Git 版本已大幅改善，但复杂的 submodule 结构仍需测试。
典型使用场景
| 场景 | 传统做法 | worktree 做法 |
|---|---|---|
| 紧急 hotfix | git stash → 切换 → 修复 → 切回 → stash pop |
新建 worktree，直接干活 |
| code review | fetch + checkout 到本地 | git worktree add ../review pr/123 |
| 并行运行多个 AI agent | 多次 clone | 多个 worktree 共享同一仓库 |
| 同时跑不同版本的测试 | 难以实现 | 每个版本一个 worktree |
小结
git worktree add 解决的是一个真实存在但长期被低估的问题：并行开发时的上下文切换成本。无论是人类开发者处理紧急插队任务，还是 AI agent 需要隔离的沙箱环境，worktree 都提供了比克隆仓库更轻量、比 stash 更干净的解决方案。
Git 2.5 带来的这个特性，在 AI 编程时代终于迎来了它应有的关注度。
觉得有用？订阅 LoreAI，每天 5 分钟掌握 AI 动态。