git-operations 是一份围绕 Git 日常与应急操作的技能文档,目标是让使用者理解 Git 的对象模型(内容寻址、不可变有向无环图、快照对象),并据此完成分支管理、提交整理、变基、冲突解决和历史恢复。文档按四个步骤组织,并附交付格式、示例、检查清单与反模式。
一、用途与核心思路 文档开篇指出 Git 不是黑盒,不应盲目复制命令。掌握对象指针、提交、树与 reflog 后,可以更干净地解决合并冲突、安全改写提交历史、在误删后恢复。
二、主要能力
- 原子分支与提交:每个提交只对应一个逻辑变更,要求可编译并通过测试;使用 git add -p 交互式暂存;提交信息采用 Conventional Commits 格式 <type>(<scope>): <short imperative summary>,类型包括 feat、fix、refactor、perf、test、docs、chore,并使用祈使现在时。
- 交互式变基与历史改写:通过 git fetch origin main 与 git rebase -i origin/main 整理功能分支,使用 pick、reword、squash、fixup 等命令压缩 WIP 提交;强调不要对公共共享分支(如 main、production)执行变基。
- 三方合并冲突解决:配置 git config --global merge.conflictstyle zdiff3 显示共同祖先;识别 HEAD、base、incoming 三种状态;解决后验证编译与单元测试,再 git add 与 git rebase --continue;可用 git rebase --abort 或 git merge --abort 中止。
- 应急恢复:用 git reflog 查看 HEAD 移动记录,用 git reset --hard HEAD@{2} 恢复快照;用 git reset --soft HEAD~1 撤销提交但保留暂存,用 git reset HEAD~1 撤销提交并取消暂存。
三、使用方式 文档以操作步骤和命令形式给出,并配套一个 GIT-RUNBOOK.md 交付模板,包含分支健康与干净历史策略、冲突解决记录表、灾难恢复计划(reflog 快照)。示例展示如何从 reflog 找回分离 HEAD 状态下丢失的提交并用 git branch 恢复。检查清单覆盖变基前同步、提交压缩、zdiff3 配置、测试通过、破坏性操作前记录 reflog。反模式包括对共享分支 force push(建议 --force-with-lease)、提交密钥、巨型合并转储。
四、适用场景 适合需要整理功能分支历史、解决复杂合并冲突、从误操作中恢复提交的开发者与团队,也可作为 Git 事故恢复与变基的操作手册。
五、限制 文档未说明其运行平台、安装方式、收费模式或自动化程度;所给命令为通用 Git 命令,实际效果取决于本地仓库状态与团队约定。