My Git Handbook
English | 中文
面向 AI Native 软件工程的 Git 变更控制手册:理解原理,验证改动,管理协作。
AI 会操作,人为什么还要学?
AI 可以代劳命令,理解决定我们能看见哪些选择、提出什么问题,以及凭什么接受结果。脑中没有一个概念,遇到问题时就很难想到用它。
我维护这个仓库,是希望把 Git 中值得传承的设计讲清楚:快照如何记录状态,对象如何复用内容,引用如何组织历史,以及协作如何处理分歧。让这些思想成为人的判断依据,让 AI 帮助我们实验、执行和验证。
学习的重心,从熟练执行,走向理解、判断与验证。 操作仍然值得练习,尤其是读懂关键命令和识别风险;实践是检验理解的方式。
读完整理念 · 直接打开交互学习
从理解设计到管理协作
先用知识地图确认自己正在解决的是原理、一次工程变更还是团队协作,再进入下面的文章。
Git 提供版本与历史的基础。测试、审查、权限、制品和发布系统一起,才能形成完整的变更控制。这里既讲工具的能力,也讲它的边界。
适合谁
- Git 新手,希望建立正确心智模型
- 普通开发者,经常需要处理冲突、回滚、误提交
- 高级开发者,关心 PR、Review、CI、发布协作
- 技术负责人,需要设计团队 Git 工作流和 GitHub 治理规范
- AI 编程用户,需要控制 Codex、Claude Code、Cursor、Cline 等工具带来的代码变更风险
目录导航
在线交互学习
通过动画、文章和临时仓库实验理解 Git 的快照、对象图、引用、历史变化、远端、worktree 与存储。十个主题按同一顺序安排,01 至 03 对应既有交互,04 至 10 对应新增交互;材料与脚本可检查,读者理解仍需要用预测、重现和迁移来验证。
打开 Git 心智模型交互实验
查看十个主题的文章、交互与实验导航
学习路径
新手路径
- 为什么在 AI 时代学习 Git
- Git 心智模型
- 十个主题的课程导航:每个主题都连接文章、交互和临时仓库实验。
- Git 基础命令
- 日常 Git 命令
日常开发路径
- 分支与合并
- Rebase 与 Merge
- Stash
- Worktree
团队协作路径
- 团队 Git 工作流指南
- GitLab Flow
- Pull Request 最佳实践
- Code Review 最佳实践
- GitHub Flow
- Trunk-Based Development
- Gitflow
GitHub 工程治理路径
- GitHub 工程治理手册
- 企业 GitHub 协作配置栈
- 分支保护
- Rulesets
- Merge Queue
- GitOps and Config as Code
- 发布管理
- AI Agent 治理
AI Native 开发路径
- 一次工程变更课程
- 接受 Agent 变更
- AI 生成变更的 CI
- 后台 Agent 任务
- AI Native Git Workflow
- AI 生成代码 Review
- Codex / Claude Code Git 实践
- AI 编程工具的 Git 集成实践
- Worktree for AI Agents
- Stacked PR for AI-Generated Changes
- AI Reviewer 与 Human Reviewer
- AI 协作度量
故障处理路径
- Git 高频事故处理手册
- Agent 事故恢复
- Undo Anything
- Recover Lost Commit
- Remove Secret from History
按问题找答案
第一阶段最值得读
推荐资料来源
新内容会优先参考官方文档和业界常用资料:
更完整的资料索引见 推荐阅读。
版本与维护计划
详细计划见 roadmap。
课程、修复和协作材料已整理为 v2.2.0 发布说明与 Changelog。发布文档准备日期为 2026-09-09;版本状态见 GitHub Releases。
已有内容会逐步纳入新的学习路径,迁移清单见 legacy content migration,资料索引见 resources。
项目治理
本仓库原创内容采用 MIT License。第三方资料、历史电子书、外部文章、链接资源和引用内容仍遵循其原始许可证和版权声明。
Contributing
欢迎贡献真实问题、团队实践、事故恢复经验、AI 编程工作流和可复用模板。
新内容请遵循 Content Style Guide。
评论