English | 中文
面向现代工程团队与 AI 编程时代的 Git / GitHub 实战手册。
这个仓库最早是 Git 学习资料合集，帮助很多中文开发者入门 Git。
如果今天还只是做“资料导航”，价值已经不够了。Git 的核心问题，已经从“命令怎么用”扩展到这些更真实的问题：
- 个人开发者如何理解 Git 的心智模型
- 日常开发中如何处理冲突、回滚、误提交
- 团队如何选择合适的分支和 PR 工作流
- 技术负责人如何用 GitHub 建立工程协作规范
- 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 | 大厂工程实践案例和决策图谱 |
通过动画理解 Git 的快照、对象图和 Index。建议按照学习顺序逐个完成，每个主题都提供可操作的演示和对应的原理文章。
- 为什么使用 Git
- Git 心智模型
- 快照与状态：HEAD、Index 与 Working Tree
- 对象图：blob、tree 与 commit
- Index 是下一次 commit 的草稿
- Git 基础命令
- 日常 Git 命令
- 团队 Git 工作流指南
- GitLab Flow
- Pull Request 最佳实践
- Code Review 最佳实践
- GitHub Flow
- Trunk-Based Development
- Gitflow
- 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
| 我现在遇到的问题 | 建议先看 |
|---|---|
| 刚把 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 清单
新内容会优先参考官方文档和业界常用资料：
更完整的资料索引见 推荐阅读。
详细计划见 roadmap。
已有内容会逐步纳入新的学习路径，迁移清单见 legacy content migration，资料索引见 resources。
本仓库原创内容采用 MIT License。第三方资料、历史电子书、外部文章、链接资源和引用内容仍遵循其原始许可证和版权声明。
欢迎贡献真实问题、团队实践、事故恢复经验、AI 编程工作流和可复用模板。
新内容请遵循 Content Style Guide。