Git

工作树Worktree

你可能会说

功能改到一半突然要修紧急 bug，我又不想收拾现在这个现场。

让同一个 Git 仓库同时出现在多个文件夹里，每个文件夹处理一条分支例如，原文件夹继续做首页，另一个文件夹单独处理线上修复，两边可以同时打开和运行。移除额外文件夹前，先保存其中的改动并停止正在运行的服务；不要直接删除文件夹，应使用 Git 的 worktree 命令移除。

同一份 Git 历史

项目主版本继续保持运行

新功能版本在另一个文件夹修改

git worktree add 新文件夹新分支

Worktree 让同一个 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 创建目录

zsh — my-first-page

$ 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 个文件尚未提交

📁 my-first-page-hotfix

hotfix/login

正式环境登录失败
在这里修复 → Commit → Push

AI 两个窗口并行修改

窗口 A

AI 正在改导航栏

my-first-page-nav · feat/nav

运行中…

窗口 B

AI 正在改定价页

my-first-page-pricing · feat/pricing

运行中…

各占一个 worktree，改完各自开 PR，互不覆盖

list 查看与 remove 清理

zsh — my-first-page

$ 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] 修复完成后，已移除链接工作目录