SuperAPI AI 工具集

worktrees

测试与质量

查看项目

更新于 10-16 01:35

技能介绍

用途:Git worktrees 让同一仓库在多个目录中同时检出不同分支,适合并行开发多个分支、不 stash 就切换上下文、边开发边审查 PR、隔离测试以及对比不同版本。核心原则是一个活跃分支对应一个 worktree,通过切换目录而非切换分支来切换上下文。

主要能力:创建、列出、移除、移动、锁定与解锁 worktree,清理失效元数据并修复链接。所有 worktree 共享同一 Git 对象数据库,不重复占用空间;每个分支同一时间只能在一个 worktree 中检出。

常用命令:git worktree add <path> <branch>;git worktree add -b <branch> <path>;git worktree add --detach <path> <commit>;git worktree list;git worktree remove <path>;git worktree move <old> <new>;git worktree lock <path>;git worktree prune;git worktree repair。

典型用法:为 hotfix 从 origin/main 新建 worktree 修复后推送;用 git fetch origin pull/123/head:pr-123 加 worktree 审查 PR;为不同版本建 worktree 后用 diff 对比;在独立 worktree 后台跑测试;用 --detach 做实验避免创建临时分支。跨 worktree 可用 git checkout <branch> -- <path>、git checkout -p、git cherry-pick 选择性合并。

限制与注意:删除 worktree 应使用 git worktree remove 而非 rm -rf,手动删除后需 git worktree prune;手动移动目录后需 git worktree repair;移除前先提交或 stash;建议使用同级目录命名,如 project-feature。资料未提供该技能的安装方式、收费与平台信息。