findscripter 何时使用
适用：合并前清理/重排/压缩提交、跨分支搬运补丁、二分定位引入 Bug 的提交、多分支并行开发、误操作后恢复丢失的提交或分支、同步已分叉的分支、准备干净可评审的 PR。
不该用（边界）：
- 与 Git 高级历史操作无关的任务。
- 普通
git add/commit/push等基础操作，无需高级技巧。 - 改写已推送且被他人共享的公共分支历史（会给协作者制造冲突）——除非确认无人依赖。
步骤
- 明确目标、约束与输入（要清理哪些提交？目标分支是什么？是否已推送？）。
- 风险操作前先建备份分支：
git branch backup-branch。 - 选择匹配的技术（rebase / cherry-pick / bisect / worktree / reflog）执行。
- 校验结果（跑测试、
git log/git status检查），确认无破坏后再推送。 - 仅在历史改写后用
git push --force-with-lease，绝不裸用--force。
指令
1. 交互式 rebase（编辑历史的瑞士军刀）
操作动词：pick 保留 / reword 改信息 / edit 改内容 / squash 合并(保留信息) / fixup 合并(丢弃信息) / drop 删除。
git rebase -i HEAD~5 # 最近 5 个提交
git rebase -i $(git merge-base HEAD main) # 本分支相对 main 的全部提交
git rebase -i abc123 # rebase 到指定提交
2. Cherry-Pick（跨分支搬运指定提交）
git cherry-pick abc123 # 单个提交
git cherry-pick abc123..def456 # 区间（不含起点）
git cherry-pick -n abc123 # 只暂存改动，不自动提交
git cherry-pick -e abc123 # 搬运并编辑提交信息
3. Bisect（二分查找引入 Bug 的提交）
git bisect start
git bisect bad # 标记当前为坏
git bisect good v1.0.0 # 标记已知好点
# git 检出中间提交 → 测试后标记 git bisect good / bad，重复直到定位
git bisect reset # 结束
# 自动化：脚本 exit 0=good，1-127(125 除外)=bad
git bisect start HEAD v1.0.0
git bisect run ./test.sh
4. Worktree（多分支并行，免 stash/切换）
git worktree list
git worktree add ../project-feature feature/new-feature
git worktree add -b bugfix/urgent ../project-hotfix main
git worktree remove ../project-feature
git worktree prune
5. Reflog（安全网，记录所有 ref 移动，含已删提交，保留约 90 天）
git reflog # 查看历史
git reflog show feature/branch
git branch recovered-branch abc123 # 从丢失的提交恢复分支
自动 squash（autosquash）
git commit --fixup HEAD # 或指定 hash
git rebase -i --autosquash main # 自动标记 fixup 提交
拆分提交
git rebase -i HEAD~3 # 把目标提交标 edit，git 停在该处
git reset HEAD^ # 撤销提交但保留改动
git add file1.py && git commit -m "feat: add validation"
git add file2.py && git commit -m "feat: add error handling"
git rebase --continue
部分 cherry-pick（只取某提交的指定文件）
git show --name-only abc123
git checkout abc123 -- path/to/file1.py path/to/file2.py
git commit -m "cherry-pick: apply specific changes from abc123"
恢复命令
git rebase --abort / git merge --abort / git cherry-pick --abort / git bisect reset
git restore --source=abc123 path/to/file # 恢复单文件到某版本
git reset --soft HEAD^ # 撤销上次提交，保留改动
git reset --hard HEAD^ # 撤销上次提交，丢弃改动
示例
合并前清理 feature 分支并安全推送：
git checkout feature/user-auth
git branch backup-user-auth # 先备份
git rebase -i main # squash 修字 / reword / 重排 / drop
git push --force-with-lease origin feature/user-auth
把热修复应用到多个 release 分支：
git checkout main && git commit -m "fix: critical security patch"
git checkout release/2.0 && git cherry-pick abc123
git checkout release/1.9 && git cherry-pick abc123
# 冲突时：git cherry-pick --continue / --abort
从误 reset 中恢复：
git reset --hard HEAD~5 # 误操作！
git reflog # 找到 def456 HEAD@{1}: commit: my important changes
git reset --hard def456 # 或 git branch recovery def456
注意事项
- rebase vs merge：清理本地提交、让分支跟进 main、追求线性历史 → rebase；把完成的功能并入 main、保留协作真实历史、公共分支 → merge。
- 始终用
--force-with-lease而非--force，避免覆盖他人工作。 - 只 rebase 尚未推送共享的本地提交；公共分支 rebase 会给协作者制造冲突。
- 复杂 rebase 前先建备份分支；出错可
git reset --hard backup-branch。 - 原子提交 + 描述清晰的提交信息；改写后务必测试。
- bisect 前先 commit 或 stash，工作区要干净。
- 记得清理废弃 worktree（
git worktree prune），否则占用磁盘。 - reflog 是 90 天内的最后救命稻草，养成意识。
互见
源技能还附带以下参考（如需深挖可查源仓库）：交互式 rebase 详解、冲突解决进阶策略、安全改写历史、PR 前清理清单、常用 Git 别名、清理已合并/陈旧分支脚本。
采编自 sickn33/antigravity-awesome-skills（MIT 许可）。