Git中常用命令速查手册

本篇是 Git 系列的第 6 篇，也是整个系列的收官之作——一份实打实的命令速查手册。

前5篇我们从入门讲到企业级实战，覆盖了本地仓库、分支管理、远程操作、多人协作和企业模型。但说实话，5篇文章里堆了100多个命令，新人最常遇到的卡点是：

• “那个命令的参数到底怎么用来着？”
• “现在这个场景到底该用哪个命令？”
• “命令这么多，能不能给我一张表直接查？”

没错，这篇就是来“治”这个问题的。

所有在前5篇中间出现过的命令，全部按功能分类整理成手册。每个命令配上一句话功能说明、最常用参数和典型示例。不用谢，它就是你的Git命令字典——以后写代码卡壳了，直接翻。

本节目标：让你手边随时有一张Git命令速查表。原理部分不再深入（详见第1-5篇），咱们只讲怎么用。

通过本文，你将掌握：

前置知识： 读过前5篇任意一篇即可。这篇是工具书，直接当字典用。

一、配置类命令

配置分3层：--system（系统级）→ --global（用户级）→ --local（仓库级）。后一层覆盖前一层。

常用一次性配置（新人必跑）：

git config --global user.name "Your Name"
git config --global user.email "your@email.com"
git config --global init.defaultBranch main
git config --global color.ui auto
git config --global pull.rebase true
git config --global core.editor vim

二、仓库初始化与克隆

一句话说清 init 和 clone 的区别：init 是从零开始，本地已经有代码想用Git管理；clone 是复制远程仓库，拿别人的代码来用。

三、文件操作

.gitignore 常用模板：

# Python
__pycache__/
*.pyc
.venv/
.env

# Ja va
*.class
*.jar
target/

# IDE
.idea/
.vscode/
*.iml

# OS
.DS_Store
Thumbs.db

# Node
node_modules/
npm-debug.log

# 自定义
logs/
*.log

四、提交与回退

reset 和 revert 的区别：reset 改写历史（危险操作），revert 创建反向commit（安全操作）。如果是已经push过的commit，用 revert。

reset 三种模式速记：

--soft   ← HEAD位置改变，工作区和暂存区不动
--mixed  ← HEAD和暂存区改变，工作区不动（默认）
--hard   ← 全部改变（最危险）

五、历史查看

推荐的 log 别名（后面有详细配置）：

git log --graph --pretty=format:'%h -%d %s (%cr) <%an>' --abbrev-commit --all

六、分支操作

merge 和 rebase 速记：

七、暂存操作

stash本质是个栈结构（LIFO：后进先出）。stash@{0} 是最新的，stash@{1} 是上一个。

八、远程操作

fetch 和 pull 速记：

九、标签

轻量tag只是个名字，附注tag包含打tag者的信息、日期和说明。发版推荐用附注tag。

十、企业级工具

10.1 git-flow（Git Flow 工具）

10.2 git worktree（多工作目录）

10.3 git submodule（子模块）

10.4 git archive（打包）

10.5 git bisect（二分查找 bug）

git bisect 是定位“哪个commit引入bug”的神器——用二分查找，比逐个commit试快100倍。

10.6 git grep（代码搜索）

十一、效率别名（强烈推荐）

11.1 一键配置

下面这段直接复制到终端运行，配置就生效了：

# log 美化
git config --global alias.lg "log --graph --pretty=format:'%h -%d %s (%cr) <%an>' --abbrev-commit --all"

# 简洁 log
git config --global alias.l "log --oneline --graph -10"

# 全部 add + 状态
git config --global alias.st "status"

# 简洁 status
git config --global alias.ss "status -s"

# 全部 add
git config --global alias.a "add -A"

# 带信息的 commit
git config --global alias.cm "commit -m"

# 撤销最后一次 commit（保留改动）
git config --global alias.undo "reset --soft HEAD~1"

# 查看所有分支
git config --global alias.br "branch -a"

# 看远程
git config --global alias.rv "remote -v"

# diff 工具
git config --global alias.d "diff"
git config --global alias.dc "diff --cached"

11.2 别名效果

配好之后：

# 等价 git log --graph --pretty=format:'%h -%d %s (%cr) <%an>' --abbrev-commit --all
git lg

# 简洁 status
git ss

# 看所有分支
git br

# 撤销最后一次 commit（保留改动）
git undo

配置一次，终身受用。建议把上面那段命令保存到笔记里，新机器上直接复制粘贴。

11.3 更多推荐别名

# 推送到当前分支的上游
git config --global alias.ps "push"

# 拉取并 rebase
git config --global alias.pl "pull --rebase"

# 看所有 stash
git config --global alias.sl "stash list"

# 看 stashes 详情
git config --global alias.ss2 "stash show -p"

# 找到删除的文件
git config --global alias.df "diff --diff-filter=D --summary"

# 今天的 commit
git config --global alias.today "log --since=midnight --author=$(git config user.name) --oneline"

# 我上周的 commit
git config --global alias.week "log --since='1 week ago' --oneline"

十二、常用操作标准流程

12.1 第一次用Git（新人必跑）

# 1. 配置身份
git config --global user.name "Your Name"
git config --global user.email "your@email.com"

# 2. 配置默认分支
git config --global init.defaultBranch main

# 3. 配置编辑器
git config --global core.editor vim

# 4. 开启颜色
git config --global color.ui auto

# 5. （可选）配 SSH Key
ssh-keygen -t ed25519 -C "your@email.com"
cat ~/.ssh/id_ed25519.pub
# 复制到 Gitee/GitHub

12.2 新项目开发流程

# 1. clone 远程仓库
git clone git@github.com:user/repo.git
cd repo

# 2. 创建 feature 分支
git switch -c feature/awesome-feature

# 3. 开发 + 提交
echo "code" > app.py
git add .
git commit -m "feat: add awesome feature"

# 4. 推送到远程
git push -u origin feature/awesome-feature

# 5. 在平台创建 PR
# 6. 团队 review + 合并

12.3 同步远程最新代码

# 标准流程（推荐）
git fetch origin
git rebase origin/master  # 或 git merge origin/master

# 或一条命令（已配置 pull.rebase = true）
git pull --rebase

12.4 解决冲突

# 1. 冲突时先看哪些文件冲突
git status

# 2. 编辑冲突文件（删 <<<<<<< ======= >>>>>>>）

# 3. 标记解决
git add 

# 4. 完成合并/rebase
git commit                      # merge 时
git rebase --continue           # rebase 时

# 5. 验证
git status  # 不应该有 Unmerged paths

12.5 紧急修复 Bug

# 1. 创建 hotfix 分支
git switch -c hotfix/critical-bug

# 2. 修复 + 提交
echo "fix" > bug.py
git add .
git commit -m "hotfix: critical bug"

# 3. 推送
git push -u origin hotfix/critical-bug

# 4. 创建 PR + 快速 review
# 5. 合并到 master + 打 tag
git switch master
git merge --no-ff hotfix/critical-bug
git tag v1.0.1
git push origin v1.0.1

12.6 发版

# 1. 切到 master
git switch master

# 2. 拉取最新
git pull --rebase

# 3. 打 tag
git tag -a v1.0.0 -m "Release 1.0.0"

# 4. 推送 tag
git push origin v1.0.0

12.7 撤销操作

# 撤销工作区修改
git restore 

# 取消暂存
git restore --staged 

# 修改最后一次 commit 信息
git commit --amend

# 撤销最后一次 commit（保留改动）
git reset --soft HEAD~1

# 撤销最后一次 commit（丢弃改动）
git reset --hard HEAD~1

# 撤销已 push 的 commit
git revert 

12.8 找回"消失"的代码

# 1. 查所有操作记录
git reflog

# 2. 找回去
git reset --hard 

十三、命令数与场景对照表

"这么多命令，平时到底用多少？"

日常工作90%只用16个核心命令。其他的是“进阶武器”，用到再查本手册。

十四、几个常见疑问

这么多命令怎么记？

分3层。

核心16个（必背）：

config, init, clone, status, add, commit,
log, diff, branch, switch, merge,
remote, fetch, pull, push, reflog

命令太长了不想打怎么办？

配别名。参考第11节，配一次终身受用。

哪个命令最容易出错？

reset --hard、push --force、clean -fd。

这3个都是不可逆的操作。执行前先问自己三个问题：真的不需要了吗？有没有备份？reflog能找回来吗？

怎么查命令的详细帮助？

用 git help 或 man git。

# 查某个命令的帮助
git help commit
# 或
git commit --help
# 或
man git-commit

# 查所有命令列表
git help -a

# 查常用工作流
git help workflows

命令记不住有没有图形化工具？

有，但不推荐。

但要注意：工具能“上手”但不能“深入”。想真正懂Git，还是得用命令行。