Git Worktrees完整上手：3步建好隔离工作空间，并行开发少踩3个坑

Git Worktrees完整上手：3步建好隔离工作空间，并行开发少踩3个坑

【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers

Superpowers 是一个给 AI 编程助手用的技能框架，它把 Git Worktrees 包进固定流程，让你在一个仓库里同时推进多个任务而互不干扰。没有这套流程时，切一次分支往往意味着未提交改动互相纠缠、依赖重装、构建缓存报废，两个任务一交错，环境就面目全非。这篇教程拆解 Superpowers 的 using-git-worktrees 技能：选址、忽略校验、创建、基线验证四件事它全做了，你只在少数决策点拍板。

⏱️ 一分钟看懂Worktrees解决什么问题

先说结论：Git Worktrees 让一个仓库同时拥有多份彼此独立的工作目录，每份目录绑定一个分支、装自己的依赖、跑自己的测试，共享同一份.git对象库。工作目录是新的，对象库是旧的：提交历史、标签、远程配置全部共享，所以新工作树无需重新克隆，也不会漏掉任何已有分支。对分支管理的直接收益见下表：

注意"独立"的边界：省掉的是重复安装与切换的时间成本，磁盘占用和分支数量照常增长，实验性分支用完要记得清理。Superpowers 的角色一句话：把裸 git 命令固化成 using-git-worktrees 技能（即 Superpowers工作树 流程）的标准流水线——选址、忽略校验、创建、装依赖、跑基线、出报告，六个环节全部自动化。

🛡️ Superpowers多做的两层保险

坑点一：目录位置各写各的手工建工作树时，目录放哪儿全凭当次决定：这次在.worktrees/，下次在worktrees/，再下次塞进项目根目录；同一个项目里新旧混放，清理时没人说得清哪个归谁管。 机制：按固定优先级选址——已有.worktrees/优先用它；只有worktrees/就用它；两者都不存在，读 CLAUDE.md 里声明的偏好；再没有，开口问你要放哪儿。这四种情况之外不引入新位置，项目结构因此保持可预期。

坑点二：工作树内容被提交进仓库.gitignore里漏掉工作树目录，主仓库的git status就会长期挂着一个整目录的未跟踪项，一次例行git add .足以把另一份工作树的全部文件写进提交历史。 机制：创建前强制跑忽略校验——

git check-ignore -q .worktrees 2>/dev/null || git check-ignore -q worktrees

未通过就先补写.gitignore并提交这次改动，然后才允许继续创建。

🌱 从零到第一个工作树的三步

第1步：检测并准备

先判定你是否已经处在链接工作树里：对比git rev-parse --git-dir与git rev-parse --git-common-dir两个路径，两者不等说明当前就是独立工作空间，直接跳到第3步，绝不嵌套再建一棵。子模块也会让这两个路径不等，需先排除。确认不在的话，按四级优先级选定目录，并完成忽略校验。

第2步：创建并进入工作树

一条命令同时建目录和开分支，分支名与目录名保持一致：

git worktree add "$path" -b "$BRANCH_NAME" cd "$path"

平台自带原生工作树工具（如EnterWorktree）时优先走它，git worktree add只是没有原生工具时的回退方案。

第3步：装依赖并跑基线测试

安装命令按项目类型自动识别：package.json对应npm install，Cargo.toml对应cargo build，Go 与 Python 同理，无需记忆任何生态特例。装完立即跑一次完整测试集。这一步的作用不是确认"能跑"，而是给工作树钉下基线：此后任何一条失败，都能先对照基线判断是否由新代码引入。基线红了不硬闯——技能会报告失败清单并停下来，继续还是排查由你决定。

三项都通过后，就绪报告长这样：

Worktree ready at /path/to/repo/.worktrees/feature-auth Tests passing (47 tests, 0 failures) Ready to implement feature-auth

三行分别回答：在哪儿、基线如何、下一步干什么。

⚡ 出状况时的决策速查

🕳️ 原生流程救不了的3个坑

你以为：工作树目录肯定早被忽略了实际发生：跳过校验直接建，主仓库git status里挂着一整个未跟踪目录；某次例行提交把它整体带进历史，此后每个分支的 diff 都混着另一棵树的代码，分支管理彻底失真。 怎么防：git check-ignore是创建前的强制门禁，未通过先落.gitignore并提交。

你以为：基线测试可以等开工之后实际发生：基线本身带 3 条历史失败，你改完代码跑测试仍然红，两条是你引入的、一条是存量，但此刻没人分得清，回滚和排查时间翻倍。 怎么防：工作树建好后的第一件正事是跑完整测试集，红了先报告、再决策。

你以为：直接敲 git 命令最快实际发生：平台自带的工作树工具管选址、管分支、管清理；绕开它手敲git worktree add，会留下一份宿主看不见的"幽灵工作树"，收尾时路径、分支、注册信息三处状态互相矛盾，清不干净。 怎么防：先探测原生工具，存在就用它，裸命令只作回退。

🧭 接下来做什么

这条流程的上游和下游都有配套技能。上游，brainstorming 完成设计并取得你批准后，自动触发 using-git-worktrees 准备隔离工作

【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers