Skip to content

xirong/my-git

Repository files navigation

My Git Handbook

面向现代工程团队与 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 等工具带来的代码变更风险

学习路径

新手路径

  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. 经典 Git 工作流教程(归档)

GitHub 工程治理路径

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

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 SplittingStacked PR for AI-Generated Changes
想保护 main 分支 Branch Protection
PR 很多,主分支经常被合坏 Merge Queue
大仓库 clone、status、checkout 很慢 Large Repository Git Practices
想直接复制团队模板 Templates

第一阶段最值得读

推荐资料来源

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

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

v2.0 维护计划

详细计划见 roadmap

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

Contributing

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

新内容请遵循 Content Style Guide

About

A practical Git & GitHub handbook for modern engineering teams and AI-native development workflows. | 现代工程团队与 AI 编程时代的 Git / GitHub 实战手册

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors