git worktree 是唯一能解决本地多分支并行开发上下文丢失、状态污染、路径混淆问题的原生方案，它通过共享.git但隔离工作目录、head和index实现真正多分支同时开发。

Git 本地多分支管理真正的效率瓶颈不在“能不能切”，而在“切完之后怎么不丢上下文、不污染状态、不记错路径”。原生 git worktree 是唯一能解这个问题的方案，其他插件或 GUI 工具（如 Sublime Text 的 Git 插件）只是封装了 git checkout，本质仍是单工作目录切换，无法并行。

git worktree add 创建时路径和分支名必须显式指定

很多人误以为 git worktree add 会自动推导分支名或默认用当前分支，其实它要求两个参数都明确给出：path 和 branch。省略 branch 会导致创建一个分离 HEAD 的工作树；省略 path 则直接报错。

• 正确写法：git worktree add ../hotfix-123 hotfix/123
• 错误写法：git worktree add ../hotfix-123（没指定分支，HEAD 分离）
• 想基于当前分支新建工作树？得先 git checkout -b new-feature，再 git worktree add ../new-feature new-feature
• 路径不能是已有 Git 仓库——git worktree 会拒绝在含 .git 的目录下创建

git worktree list 输出不可靠，别直接 parse

git worktree list 的输出是面向人看的纯文本，列之间用空格分隔，但路径里可能含空格，分支名也可能含空格（虽然不推荐），导致 shell 脚本解析极易出错。它也不区分主工作树和附加工作树，更不报告是否 locked 或 prunable。

alfred-github-backup

GitHub 仓库备份技能 - 将 OpenClaw 工作空间自动或手动备份至 GitHub 私有仓库。支持自动定时备份和手动交互式配置，引导完成 Token 配置、仓库创建、首次备份及定时任务设置。用途：(1) 首次设置 (2) 日常备份。

下载

• 不要用 awk '{print $1}' 提取路径——遇到 /Users/me/My Project 就崩
• 真正安全的方式是用 git worktree list --porcelain（Git 2.28+），输出格式稳定，每行以 worktree、HEAD、branch 开头，可被脚本可靠消费
• 主工作树永远排第一，但 --porcelain 不标记它，需比对路径是否等于 $(git rev-parse --git-common-dir | sed 's|/objects$||')

git worktree remove 失败常见于未提交或未 push 的修改

git worktree remove 默认拒绝删除含未提交变更或未推送提交的工作树，这是保护机制，不是 bug。但它不会告诉你具体哪条 commit 没 push，只报 error: working tree '<path>' is not clean</path>。

• 先进到该目录：cd ../bugfix-456
• 运行 git status 看是否有 uncommitted changes
• 运行 git log origin/main..HEAD（假设你跟踪 origin/main）确认是否有未推送提交
• 若确定可丢弃，加 -f： git worktree remove -f ../bugfix-456
• 注意：-f 不会删 .git/worktrees/xxx 下的元数据，后续需手动 git worktree prune

Sublime Text 的 Git 插件根本不支持 worktree 切换

wbond 的官方 Git 插件只监听项目根目录的 .git，所有命令（包括 Git: Checkout Branch）都作用于主工作树。它完全不知道你有其他 worktree，也不会在状态栏显示当前 worktree 对应的分支。

• 你在 ../feature-x 目录里用 Sublime 打开文件，插件仍认为你在主工作树里操作
• Git: Checkout Branch 运行的是 git checkout，不是 git -C ../feature-x checkout
• 真正支持 worktree 的编辑器只有 VSCode（通过工作区文件夹识别）、JetBrains 全家桶（自动检测 .git/worktrees/）
• 如果硬要用 Sublime，只能把每个 worktree 当作独立项目打开，但插件不会跨项目同步 fetch/pull 状态

worktree 的核心约束始终是：所有工作树共享同一个 .git 目录，但各自拥有独立的 index、HEAD 和工作文件。这意味着任何影响全局状态的操作（如 git fetch、git gc）在一个 worktree 执行，其他 worktree 都立刻可见；但所有本地配置（如 core.excludesFile）和钩子也必须统一管理，没法 per-worktree 设置。