my-git

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 实战手册。

适合谁

目录导航

目录 主要内容
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 心智模型交互实验

学习路径

新手路径

  1. 为什么使用 Git
  2. Git 心智模型
  3. 快照与状态：HEAD、Index 与 Working Tree
  4. 对象图：blob、tree 与 commit
  5. Index 是下一次 commit 的草稿
  6. Git 基础命令
  7. 日常 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

第一阶段最值得读

推荐资料来源

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

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

v2.0 维护计划

详细计划见 roadmap。

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

项目治理

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

Contributing

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

新内容请遵循 Content Style Guide。

This site is open source. Improve this page.