Quick Start
快速开始
先用几个低风险命令建立对分支、提交和同步的直觉。
初始化仓库
了解 git init、git clone、身份配置和默认分支。
git clone repo-url暂存与提交
理解工作区、暂存区和提交历史的三层关系。
git add . && git commit同步远端
掌握 fetch、pull、push 与本地分支的协同方式。
git fetch originStart Here
先选一种进入方式
有些读者带着目标来，有些读者带着问题来。把两种入口合成一个更紧凑的导航舱。
Changelog
最新更新
这里优先展示最近补入或扩写的教材入口，方便快速跟进新增内容。
工作流
Gitflow 工作流教程
基于 Atlassian 对 Gitflow 的说明，梳理 main、develop、feature、release、hotfix 的职责，以及它在现代团队中的适用边界。
工作流AI Coding Agent 下的 git worktree 模式
把 git worktree 变成 AI coding agent 的默认并行工作模式，减少上下文污染、提升回滚安全性，并让多任务协作更清晰。
工作流Stacked Pull Requests 工作流
把一个大改动拆成有依赖关系的多层 PR，提升评审吞吐与可读性，同时降低一次性大 PR 的认知负担。
工作流回归问题 bisect 排查工作流
当出现“最近坏了但不知道谁改坏的”问题时，用 git bisect 通过二分定位首个坏提交，显著缩短排查路径。
Best Practices
最佳实践
减少历史污染和冲突成本。
Git Internals
底层原理
把命令行为和对象模型对应起来。
Workflows
常见工作流
把日常协作流程拆成可复用的模式。
先 fetch 再决定
把观察和整合拆成两步，比默认 pull 更可控。
功能分支协作
通过主题分支隔离开发，降低主分支的不稳定风险。
紧急修复流程
hotfix 分支的创建、修复、合并与回滚全流程。
Recovery
误操作恢复
误操作后的定位、判断与恢复路径。
先查 reflog 再操作
reset、rebase、删分支前确认可恢复位置。
reset 自救分级
--soft、--mixed、--hard 三级的风险与适用场景。
detached HEAD 处理
进入 detached HEAD 后如何安全回到正常状态。
Reference
命令参考路线
把高频命令整理成渐进式学习路径。
FAQ
常见问题
基于 Git 官方文档与官方书中的高频问题整理出一组上手最常见的答疑。
`git pull` 会先执行 fetch，再把上游分支整合进当前分支。官方文档说明它可以走 `--ff-only`、`--rebase`、`--no-rebase` 或 `--squash` 等不同路径，所以结果取决于你的命令参数和 `pull.rebase`、`pull.ff` 等配置。想减少意外，最稳妥的习惯仍然是先 fetch，再明确决定是 merge 还是 rebase。
官方手册把区别讲得很明确：`--soft` 只移动 HEAD，保留暂存区和工作区；`--mixed` 会把暂存区重置到目标提交，但保留工作区改动；`--hard` 会同时改写 HEAD、暂存区和工作区。也就是说，真正危险的是 `--hard`，因为它会直接覆盖当前文件状态。
很多时候可以。Git 官方在 `git reset` 文档里专门说明了 `ORIG_HEAD` 和 reflog 的用途：reset、merge、pull 这类操作通常会留下可回溯的引用。只要对象还没被垃圾回收清理掉，通常都能先通过 reflog 找到原来的提交，再决定是新建分支还是回退引用。