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 的默认并行工作模式,减少上下文污染、提升回滚安全性,并让多任务协作更清晰。
恢复与排障pull 之后后悔了怎么撤回
当 pull 之后发现分支状态不对、自动 merge 不符合预期,或者 rebase 结果混乱时,先判断 pull 实际做了什么,再选择 ORIG_HEAD、reflog 或救援分支。
命令专题git-worktree 教程
为同一仓库创建多个并行工作目录,避免频繁 stash/switch,提高多任务协作与紧急切换效率。
Best Practices
最佳实践
减少历史污染和冲突成本。
Git Internals
底层原理
把命令行为和对象模型对应起来。
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 找到原来的提交,再决定是新建分支还是回退引用。