SuperAPI AI 工具集

worktree

编程与开发

查看项目

更新于 10-15 23:34

技能介绍

用途:通过 git worktree 同时检出多个分支,实现并行开发,避免频繁 stash 或切换上下文。

主要能力:列出 worktree(git worktree list,支持 --porcelain 机器可读格式);创建(从已有分支、用 -b 新建分支、指定路径、--detach 分离 HEAD);移除(含 --force 强制移除未提交更改);清理(git worktree prune,可加 --verbose);移动(git worktree move);锁定与解锁(git worktree lock,可加 --reason,git worktree unlock)。

典型用法:并行功能开发时主仓库检出 feature-a,另建 feature-b 的 worktree;紧急修复时用 git worktree add ../myproject-hotfix -b hotfix/urgent main 建独立目录,提交推送后用 gh pr create 建 PR,再 git worktree remove 清理;审查 PR 时用 git fetch origin pull/123/head:pr-123 后建 worktree 测试;长期对比时分别建基线 worktree 跑测试并 diff 日志。

共享与隔离:各 worktree 共享 .git 目录(refs、objects)、远程配置与 hooks;各自拥有独立工作目录、索引(暂存区)与 HEAD。

限制与注意:需 Git 2.5+;同一分支不能同时检出到多个 worktree,否则报错;删除目录后需 prune 清理陈旧引用;建议使用描述性路径、避免嵌套 worktree、为长期任务加锁、每个 worktree 单独 IDE 窗口并各自安装依赖;与 beads 任务跟踪器同用时需禁用守护进程(export BEADS_NO_DAEMON=1 或 bd --no-daemon)。