My Git Handbook

English | 中文

面向现代工程团队与 AI 编程时代的 Git / GitHub 实战手册。

为什么维护这个仓库

这个仓库最早是 Git 学习资料合集，帮助很多中文开发者入门 Git。

如果今天还只是做“资料导航”，价值已经不够了。Git 的核心问题，已经从“命令怎么用”扩展到这些更真实的问题：

1. 个人开发者如何理解 Git 的心智模型
2. 日常开发中如何处理冲突、回滚、误提交
3. 团队如何选择合适的分支和 PR 工作流
4. 技术负责人如何用 GitHub 建立工程协作规范
5. AI 编程时代，如何审查、拆分、验证和回滚 AI 生成的代码变更

v2.0 版本的定位是：

一个面向现代工程团队与 AI 编程时代的 Git / GitHub 实战手册。

适合谁

• Git 新手，希望建立正确心智模型
• 普通开发者，经常需要处理冲突、回滚、误提交
• 高级开发者，关心 PR、Review、CI、发布协作
• 技术负责人，需要设计团队 Git 工作流和 GitHub 治理规范
• AI 编程用户，需要控制 Codex、Claude Code、Cursor、Cline 等工具带来的代码变更风险

目录导航

目录	主要内容
01-getting-started	Git 入门、心智模型、Git 和 SVN 的区别
02-daily-workflow	日常命令、分支合并、rebase、stash、worktree
03-team-collaboration	团队工作流、PR、Code Review、协作模型选型
04-github-engineering	分支保护、Rulesets、CODEOWNERS、CI、发布、安全
05-ai-native-development	AI 编程下的 diff 审查、commit 拆分、worktree、多 Agent
06-troubleshooting	Git 误操作恢复、冲突处理、secret 清理、force push 恢复
07-large-repo	大仓库、monorepo、partial clone、sparse checkout、Git LFS
08-templates	PR、Issue、Review、Hotfix、Release、AI Review 模板
10-company-practices	大厂工程实践案例和决策图谱

学习路径

新手路径

1. 为什么使用 Git
2. Git 心智模型
3. Git 基础命令
4. 日常 Git 命令

日常开发路径

1. 分支与合并
2. Rebase 与 Merge
3. Stash
4. Worktree

团队协作路径

1. 团队 Git 工作流指南
2. GitLab Flow
3. Pull Request 最佳实践
4. Code Review 最佳实践
5. GitHub Flow
6. Trunk-Based Development
7. Gitflow

GitHub 工程治理路径

1. GitHub 工程治理手册
2. 企业 GitHub 协作配置栈
3. 分支保护
4. Rulesets
5. Merge Queue
6. GitOps and Config as Code
7. 发布管理
8. AI Agent 治理

AI Native 开发路径

1. AI Native Git Workflow
2. AI 生成代码 Review
3. Codex / Claude Code Git 实践
4. AI 编程工具的 Git 集成实践
5. Worktree for AI Agents
6. Stacked PR for AI-Generated Changes
7. AI Reviewer 与 Human Reviewer

故障处理路径

1. Git 高频事故处理手册
2. Undo Anything
3. Recover Lost Commit
4. Remove Secret from History

按问题找答案

我现在遇到的问题	建议先看
刚把 commit 提交到了错误分支	Committed to Wrong Branch
reset、rebase、force push 后不知道怎么恢复	Git 高频事故处理手册
团队不知道该选 GitHub Flow、Gitflow 还是 Trunk-Based Development	团队 Git 工作流指南
PR 太大，Review 很慢	Pull Request 最佳实践
AI 一次改了很多文件，不知道怎么审	AI 变更审查实战样例
AI 生成的大 diff 需要拆 commit 或拆 PR	AI Commit Splitting、Stacked PR for AI-Generated Changes
想保护 main 分支	Branch Protection
AI agent 开始直接提交代码、发 PR，不知道怎么管	AI Agent 治理
想给团队仓库写一份 agent 协作约定	AGENTS.md 模板
PR 很多，主分支经常被合坏	Merge Queue
大仓库 clone、status、checkout 很慢	Large Repository Git Practices
想直接复制团队模板	Templates

第一阶段最值得读

• AI Native Git Workflow
• Codex / Claude Code Git 实践
• AI 编程工具的 Git 集成实践
• AI 变更审查实战样例
• Stacked PR for AI-Generated Changes
• Git 高频事故处理手册
• 团队 Git 工作流指南
• GitHub 工程治理手册
• 企业工程实践案例库
• 大厂工程实践决策图谱
• AI 代码 Review 清单

推荐资料来源

新内容会优先参考官方文档和业界常用资料：

• Pro Git
• Git 官方文档
• GitHub Docs
• Atlassian Git tutorials
• Trunk Based Development
• Git Flight Rules

更完整的资料索引见 推荐阅读。

v2.0 维护计划

详细计划见 roadmap。

已有内容会逐步纳入新的学习路径，迁移清单见 legacy content migration，资料索引见 resources。

项目治理

• License
• Contributing
• Roadmap
• Maintainers
• Agent 协作约定

本仓库原创内容采用 MIT License。第三方资料、历史电子书、外部文章、链接资源和引用内容仍遵循其原始许可证和版权声明。

Contributing

欢迎贡献真实问题、团队实践、事故恢复经验、AI 编程工作流和可复用模板。

新内容请遵循 Content Style Guide。