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 的职责,以及它在现代团队中的适用边界。
工作流Stacked Pull Requests 工作流
把一个大改动拆成有依赖关系的多层 PR,提升评审吞吐与可读性,同时降低一次性大 PR 的认知负担。
工作流Merge Queue 工作流
当团队并发合并很多 PR 时,用 merge queue 降低串行抢占主线、重复排队和基底过期的问题。
工作流Trunk-Based Development 工作流
用短生命周期分支和高频小批次合并,把主线始终保持在可发布状态,降低长期分叉与集成冲突成本。
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 找到原来的提交,再决定是新建分支还是回退引用。