Git 使用指南

这一组笔记不是按命令分类，而是按开发现场来拆。

很多时候我们不是不知道 Git 有什么命令，而是到了具体场景，不确定该选哪一个：是 merge 还是 rebase，是 reset 还是 revert，要不要先 stash。所以这里更关心选择题，不只关心语法题。

先说几个约定

• 默认主干分支写作 main，如果你的项目还在用 master，把命令里的分支名替换掉即可
• 我会优先写 git switch 和 git restore。老项目里常见的 git checkout 仍然能用，只是职责没有拆得这么清楚
• 命令只写关键参数，不会把帮助文档抄一遍

我自己用 Git 的几个习惯

• 开工前先同步主干，再切新分支
• 提交尽量小一点，不要把“改需求 + 顺手重构 + 修格式”糊成一个 commit
• 公共分支尽量少改历史；真要改，用 --force-with-lease，不要裸 --force
• 误操作之后先看 git status、git log、git reflog，不要一慌就继续乱敲命令

这部分怎么组织

• 基础部分解决“日常开发怎么做”
• 高级操作解决“现场很乱时怎么收拾”
• 决策与排错部分解决“到底该选哪个动作”
• 协作约定部分解决“团队里最好统一哪些默认动作”

如果你是按需查阅，侧边栏里直接跳场景就行。

如果你现在只想快速找命令

先看 Git 现场速查，再决定要不要深入看具体章节。