工作树Worktree
你可能会说
功能改到一半突然要修紧急 bug，我又不想收拾现在这个现场。
让同一个 Git 仓库同时出现在多个文件夹里，每个文件夹处理一条分支例如，原文件夹继续做首页，另一个文件夹单独处理线上修复，两边可以同时打开和运行。移除额外文件夹前，先保存其中的改动并停止正在运行的服务；不要直接删除文件夹，应使用 Git 的 worktree 命令移除。
你可以这样告诉 AI Agent
请保留当前首页 Worktree，为最新 main 上的 hotfix 分支创建独立 Worktree 和目录。分别使用不同端口运行；修复合并后先确认目录干净、服务停止，再用 Git Worktree 命令移除。
什么时候用
- 当前任务不能中断、又要临时处理另一件事时创建 Worktree$ git worktree add -b hotfix/login ../my-first-page-hotfix mainPreparing worktree (new branch 'hotfix/login')HEAD is now at a1b2c3d 首页基础版本
- 让每个文件夹对应一条明确分支，避免内容混在一起📁 my-first-pagemain · 首页改动尚未提交📁 my-first-page-hotfixhotfix/login · 修复登录问题
- 使用列表命令确认每个文件夹与分支的对应关系窗口 AAI 修改 feat/nav 导航窗口 BAI 修改 feat/pricing 定价页每个目录对应独立分支，改动不会互相覆盖
- 确认改动已保存且服务已停止后，再移除 Worktree$ git worktree remove ../my-first-page-hotfix$ git worktree list/Users/hu/my-first-page a1b2c3d [main]已移除链接工作目录，仅保留主工作目录
什么时候不用
- 只是普通切换任务也创建许多工作树，让目录越来越难管理$ git checkout hotfix/loginerror: Your local changes would be overwritten by checkout.未提交改动阻止切换分支，需要先处理这些改动
- 在两个文件夹里同时尝试打开同一条分支$ git worktree listmy-first-page a1b2c3d [main]my-first-page-hotfix a1b2c3d [hotfix/login]my-first-page-test 0f1e2d3 [feat/test]my-first-page-old 9a8b7c6 [feat/old]未清理的工作目录会占用磁盘并增加维护成本
- 未保存改动或仍有服务运行时就移除目录$ git worktree add ../dup mainfatal: 'main' is already checked out at '…/my-first-page'同一个分支同时只能在一个目录工作
- 直接删除文件夹；应使用 Worktree 的移除命令更新 Git 记录📁 my-first-page-hotfix右键 → 移到废纸篓Git 仍保留该工作目录的注册信息
组成结构 · Anatomy
🗄 同一个本地仓库（.git）共享历史和分支引用
📁 my-first-pagemain主工作目录
📁 my-first-page-hotfixhotfix/loginadd 出来的隔壁目录
主工作目录包含 .git；所有 worktree 共享同一套历史和分支引用
常用的工作目录，当前检出 main 分支
通过 worktree add 创建的额外目录，检出另一条分支
常见变体 · Variants
新建分支目录Add
git worktree add -b hotfix/login ../hotfix main
要从 main 新开分支和工作目录时
查看清单List
git worktree list
查看已有工作目录及其分支
移除目录Remove
git worktree remove ../hotfix
完成任务并确认无需保留目录后
典型使用场景
git worktree add 创建目录
$ git worktree add -b hotfix/login ../my-first-page-hotfix main
Preparing worktree (new branch 'hotfix/login')
HEAD is now at a1b2c3d 首页基础版本
$ ls ..
my-first-page my-first-page-hotfix
已创建额外工作目录，共用同一仓库历史
额外目录处理修复
📁 my-first-page
main
首页改动尚未完成
3 个文件尚未提交
3 个文件尚未提交
📁 my-first-page-hotfix
hotfix/login
正式环境登录失败
在这里修复 → Commit → Push
在这里修复 → Commit → Push
AI 两个窗口并行修改
窗口 A
运行中…
AI 正在改导航栏
my-first-page-nav · feat/nav
窗口 B
运行中…
AI 正在改定价页
my-first-page-pricing · feat/pricing
各占一个 worktree，改完各自开 PR，互不覆盖
list 查看与 remove 清理
$ git worktree list
/Users/hu/my-first-page a1b2c3d [main]
/Users/hu/my-first-page-hotfix e5f6a7b [hotfix/login]
$ git worktree remove ../my-first-page-hotfix
$ git worktree list
/Users/hu/my-first-page a1b2c3d [main]
修复完成后，已移除链接工作目录
延伸阅读 · 权威出处
快速练习
首页分支正在运行且改到一半，现在要并行修复线上 Bug，又不想收起当前改动或切换分支。怎样做？
ANS 原创方法