Git 命令速查 —— 100+ 真实命令带常见坑与例子

在当前目录初始化一个空的 git 仓库。

⚠ 常见坑: 已经是 git 仓库的目录里再 init 会嵌套出新的 .git，工具会混乱。先 git status 确认。

git init

git init my-project

把远端仓库连同完整历史克隆到本地新目录。

⚠ 常见坑: 巨型仓库可加 --depth=1 浅克隆；浅克隆不能 push --amend，要先 git fetch --unshallow。

git clone https://github.com/user/repo.git

git clone --depth=1 https://github.com/user/repo.git

显示工作区已改、已暂存和未跟踪的文件。

git status

git status -s

把文件（或用 . 全部）加入下一次提交的暂存区。

⚠ 常见坑: `git add .` 在子目录里只暂存子树；要全仓库（含删除）用 git add -A。

git add src/index.ts

git add .

git add -A

git add -p

把已暂存的改动以指定信息提交一次。

⚠ 常见坑: 忘记 add 会报“no changes”；-am 只暂存已跟踪文件，新文件不会被带进去。

git commit -m "fix: handle null user"

git commit -am "wip"

用新的提交替换最后一次提交（可改信息或内容）。

⚠ 常见坑: 改已 push 的提交会改写历史，协作者必须强制 pull，否则冲突。

git commit --amend

git commit --amend --no-edit

git commit --amend -m "better message"

把当前分支的本地提交推送到对应远端分支。

git push

git push origin main

把新本地分支推上远端并设置为跟踪分支（之后 git push 默认推这里）。

⚠ 常见坑: 不加 -u 的话，之后 git push 还要重新指定 remote 和分支名。

git push -u origin feature/login

从跟踪的远端分支拉取更新并合并到当前分支。

⚠ 常见坑: 默认 pull = fetch + merge，会产生“merge of remote-tracking branch”这种空合并提交。多数团队偏好 pull --rebase。

git pull

git pull --rebase

从远端拉新提交和引用到本地，但不会合并进任何分支。

git fetch

git fetch origin

git fetch --all --prune

只克隆最新一个提交（无历史）。CI 构建里能省大量带宽和时间。

⚠ 常见坑: 浅克隆不能 push、rebase，需先 git fetch --unshallow。

git clone --depth=1 https://github.com/torvalds/linux.git

重命名或移动文件，并一次性暂存改动。

git mv old-name.ts new-name.ts

只显示最近 5 个提交（任意数字皆可）。

git log -n 5

git log -3 --oneline

在当前提交创建轻量 tag。用 -a 创建带消息和打 tag 人的注释 tag。

⚠ 常见坑: 发布版本推荐用注释 tag（git tag -a v1.0 -m "..."），轻量 tag 不存元信息。

git tag v1.0.0

git tag -a v1.0.0 -m "first stable release"

删除本地 tag。要同时删远端 tag：git push --delete origin <name>。

git tag -d v1.0.0

git push --delete origin v1.0.0

从工作区删除文件并暂存这次删除。

⚠ 常见坑: 只想取消跟踪不要真删本地文件，用 git rm --cached（比如刚加进 .gitignore 的文件）。

git rm secret.env

git rm --cached config.local.json

列出本地分支；带 * 的是当前分支。

git branch

git branch -a

git branch -vv

基于当前 HEAD 创建新分支，但不切换过去。

git branch feature/login

安全删除本地分支（有未合并提交会拒绝）。

⚠ 常见坑: 强删未合并分支用 -D（大写），删了只能靠 reflog 找回。

git branch -d feature/done

git branch -D feature/wip

重命名当前分支。

git branch -m main

git branch -m old-name new-name

切换到已有分支（老命令；新命令是 git switch）。

⚠ 常见坑: `git checkout <file>` 和 `git checkout <branch>` 是两个完全不同的操作却同名，容易误操作。改用 git switch / git restore。

git checkout main

git checkout -

基于当前 HEAD 创建新分支并切过去（一步完成）。

git checkout -b feature/login

git checkout -b hotfix origin/main

切换到已有分支。git checkout <分支> 的现代替代。

git switch main

git switch -

创建并切换到新分支。git checkout -b 的现代替代。

git switch -c feature/login

git switch -c hotfix origin/main

把指定分支合并到当前分支。

⚠ 常见坑: 默认 merge 可 fast-forward 时也会快进。要强制不快进用 --no-ff，要拒绝非 FF 用 --ff-only。

git merge feature/login

git merge --no-ff feature/login

git merge --ff-only origin/main

中止进行中的 merge，回到 merge 之前的状态。

git merge --abort

把当前分支的提交搬到 <branch> 顶部重放。历史线性，但所有 commit ID 会变。

⚠ 常见坑: 已 push 到共享分支的提交不要 rebase，协作者每次 pull 都冲突。

git rebase main

git rebase origin/main

中止进行中的 rebase，回到 rebase 前的状态。

git rebase --abort

rebase 冲突解决后继续重放剩余提交。

git add resolved-file.ts && git rebase --continue

把指定提交的改动作为新提交应用到当前分支。

⚠ 常见坑: cherry-pick 出来的提交 SHA 是新的；同一改动 cherry-pick 两次会有重复逻辑。

git cherry-pick a1b2c3d

git cherry-pick a1b2c3d..f4e5d6c

git cherry-pick -x a1b2c3d

列出所有分支（本地 + 远程跟踪）。

git branch -a

列出已完全合并到当前分支的本地分支 —— 可放心删除。

git branch --merged main

git branch --merged | grep -v "\*" | xargs git branch -d

把文件从暂存区撤出（工作区改动保留）。

git reset HEAD src/index.ts

git reset HEAD .

撤销最后一次提交，但改动留在暂存区。最“无害”的 reset。

git reset --soft HEAD~1

撤销最后一次提交并取消暂存，但工作区改动保留（reset 默认行为）。

git reset HEAD~1

git reset --mixed HEAD~1

彻底丢弃最后一次提交，并清空对应的工作区改动。破坏性操作。

⚠ 常见坑: 没 commit 又不在 reflog 里的东西就真没了。可能后悔就先 git stash。

git reset --hard HEAD~1

git reset --hard origin/main

生成一个新提交，把 <sha> 的改动反向应用。共享分支安全 —— 不改写历史。

git revert a1b2c3d

git revert HEAD

git revert -m 1 <merge-sha>

丢弃文件的未暂存改动（git checkout -- 的现代替代）。

git restore src/broken.ts

git restore .

把文件从暂存区撤出但保留工作区改动（git reset HEAD <file> 的现代替代）。

git restore --staged src/index.ts

把未提交改动（已暂存 + 未暂存）压栈，并把工作区还原。

⚠ 常见坑: 默认 git stash 不会包含未跟踪的新文件；要包含用 git stash -u。

git stash

git stash -u

git stash push -m "WIP login form"

把最近一次 stash 应用回工作区并从栈里移除。

⚠ 常见坑: pop 冲突时 stash 不会被弹出，解决冲突后要手动 git stash drop。

git stash pop

git stash pop stash@{2}

列出所有 stash，含索引和消息。

git stash list

删除某个 stash 而不应用它。

git stash drop

git stash drop stash@{1}

查看 HEAD 的本地移动历史。找回丢失提交/分支的救命稻草。

⚠ 常见坑: reflog 只存在本地，不会跟随 push/clone 走。默认 90 天过期。

git reflog

git reset --hard HEAD@{1}

删除工作区里未跟踪的文件 (-f) 和目录 (-d)。

⚠ 常见坑: 不可逆。先用 git clean -nfd 干跑看会删什么。

git clean -nfd

git clean -fd

git clean -fdx

列出所有远端，含 fetch 和 push 的 URL。

git remote -v

用指定短名添加一个新远端（一般是 origin 或 upstream）。

git remote add origin https://github.com/me/repo.git

git remote add upstream https://github.com/orig/repo.git

修改已有远端的 URL（例如从 HTTPS 切到 SSH）。

git remote set-url origin git@github.com:me/repo.git

重命名一个远端。

git remote rename origin github

彻底移除一个远端配置（不会删远端仓库本身）。

git remote remove old-upstream

从远端拉取，并清理那些远端已删的远程跟踪分支。

git fetch --prune

git fetch -p origin

从远端拉取并把本地提交 rebase 到上面 —— 历史线性，没有 merge commit。

⚠ 常见坑: 远端有不相关改动导致 rebase 失败时，用 git rebase --abort 退回去。

git pull --rebase

git config --global pull.rebase true

把本地 tag 推到远端（普通 push 不会带上 tag）。

git push --tags

git push origin v1.2.0

删除远端的某个分支。

git push --delete origin feature/old

git push origin :feature/old

不克隆即可列出远端的 refs（分支、tag）。下载前先看仓库情况很有用。

git ls-remote https://github.com/torvalds/linux.git

git ls-remote --heads origin

强推，但仅当远端 tip 还是你上次看到的状态。安全版强推。

⚠ 常见坑: --force 会无声覆盖同事的工作；共享分支永远用 --force-with-lease。

git push --force-with-lease

git push --force-with-lease origin feature/login

交互式改写最近 N 个提交：reorder / squash / fixup / reword / drop。

⚠ 常见坑: 改写已 push 的提交 = 改写历史。只在自己未 PR 的分支上做。

git rebase -i HEAD~5

git rebase -i main

生成一个针对 <sha> 的 fixup 提交。配合 git rebase -i --autosquash 会自动合到对应位置。

git commit --fixup=a1b2c3d

git rebase -i --autosquash main

把 <branch> 的所有提交压成一个未提交的暂存改动 —— 由你写一条总结提交。

git merge --squash feature/login

git commit -m "feat: login flow"

为自 <branch> 起的每个提交生成 .patch 文件。用于把补丁邮件发给邮件列表（Linux 内核风格）。

git format-patch main

git format-patch -1 HEAD

把 format-patch 生成的邮件式补丁作为提交应用上去。

git am 0001-fix-bug.patch

生成变更摘要，请上游维护者从你这里 pull（GitHub 之前的协作流程）。

git request-pull v1.0 https://github.com/me/repo feature-x

自动 stash 脏工作区 → pull --rebase → 自动 unstash。日常 pull 的好别名。

git pull --rebase --autostash

git config --global rebase.autoStash true

把另一个分支 checkout 到独立的工作目录 —— 两个分支并行开发不用 stash。

⚠ 常见坑: worktree 共享同一个 .git，reflog/index 操作仍互相影响。用 git worktree list 查看。

git worktree add ../hotfix hotfix/login

git worktree list

git worktree remove ../hotfix

设置全局 git 作者名（对所有仓库生效）。

git config --global user.name "Alice Wang"

设置全局 git 作者邮箱。

⚠ 常见坑: 工作仓库里改用 git config user.email（不加 --global）单独配，跟个人项目分开。

git config --global user.email "alice@company.com"

git config user.email "alice@personal.com"

按生效顺序列出所有 config（system + global + local）。

git config --list

git config --list --show-origin

创建自定义 git 别名。常用：co=checkout、br=branch、st=status、lg="log --oneline --graph"。

git config --global alias.co checkout

git config --global alias.lg "log --oneline --graph --all"

设置 git 写 commit 信息、交互式 rebase 等用的编辑器。

git config --global core.editor "code --wait"

git config --global core.editor "vim"

让 git init 默认创建 main 分支而不是 master。

git config --global init.defaultBranch main

让 git pull 默认 rebase（不再误产生 merge commit）。

git config --global pull.rebase true

提交时把 CRLF 转 LF，但 checkout 不转。macOS/Linux 跨平台仓库推荐这样设。

⚠ 常见坑: Windows 上推荐值是 true（checkout 时 CRLF、commit 时 LF）。两边混用会出现“假改动”diff。

git config --global core.autocrlf input

删除某条 git config 配置。

git config --global --unset user.email

git config --unset alias.co

显示当前分支的提交历史。

git log

git log -n 10

git log --author="Alice"

所有分支的紧凑单行图状日志 —— 最常用的 git log 组合。

git log --oneline --graph --all

git log --oneline --graph --all --decorate

显示提交历史，并附带每次提交的完整 diff。

git log -p

git log -p src/index.ts

显示提交历史，附文件变更统计（哪些文件、多少行）。

git log --stat

git log --stat -n 5

显示未暂存的改动（工作区 vs 暂存区）。

git diff

git diff src/index.ts

显示已暂存的改动（暂存区 vs 上次提交）—— 即 git commit 会记录的内容。

git diff --staged

git diff --cached

显示两个分支顶端之间的 diff。

git diff main..feature/login

git diff origin/main..HEAD

显示 <branch2> 自从与 <branch1> 分叉以来的改动（用 merge base）。PR 预览常用。

⚠ 常见坑: 两点 vs 三点 diff 结果不同 —— PR 实际显示的是三点版本。

git diff main...feature/login

对文件每一行显示最后修改它的提交和作者。

⚠ 常见坑: 空格/格式化提交会把真作者挡住。用 git blame -w --ignore-rev <格式化提交> 跳过它们。

git blame src/index.ts

git blame -L 10,30 src/index.ts

git blame -w src/index.ts

显示一个提交的元信息和 diff。

git show a1b2c3d

git show HEAD

git show HEAD:src/index.ts

按作者汇总提交数（排序、编号）。生成 changelog/致谢列表很好用。

git shortlog -sn

git shortlog -sn --since="1 month ago"

在提交历史上二分查找引入 bug 的那次提交。

git bisect start

git bisect bad

git bisect good v1.0

git bisect reset

查找新增或删除过指定文本的每个提交 —— “这个字符串是何时出现的？”神器。

git log -S "TODO" --source --all

git log -S "DEBUG_FLAG"

在已跟踪文件里按正则搜索（比 grep 快且尊重 ignore 规则）。

git grep "TODO"

git grep -n "TODO" -- "*.ts"

只列出有改动的文件名，不显示 diff 内容。配合 pipe 给其他命令很方便。

git diff --name-only

git diff --name-only origin/main...HEAD | xargs eslint

按日期范围过滤提交。支持 "2 weeks ago" 这种自然语言或 ISO 日期。

git log --since="2 weeks ago"

git log --since=2026-01-01 --until=2026-02-01

把另一个 git 仓库作为子模块加到指定路径。

⚠ 常见坑: submodule 钉的是某个具体提交，不是分支。新克隆要 git submodule update --init --recursive，否则子模块目录是空的。

git submodule add https://github.com/user/lib.git vendor/lib

把 .gitmodules 里登记的 submodule 写进本地 .git/config。

git submodule init

初始化、拉取并 checkout 所有 submodule（含嵌套）到登记的提交。

git submodule update --init --recursive

git clone --recurse-submodules <url>

把每个 submodule 推到其跟踪远端分支的最新提交（之后要在父仓库提交一次）。

git submodule update --remote

git submodule update --remote vendor/lib

在每个 submodule 里执行 shell 命令。适合批量 git 操作。

git submodule foreach git pull

git submodule foreach "git checkout main && git pull"

干净地移除 submodule：deinit 注销，再 git rm <path> 并提交。

⚠ 常见坑: 直接删目录会留下旧的 .gitmodules / .git/config 配置。要 deinit + rm 双步。

git submodule deinit vendor/lib

git rm vendor/lib && rm -rf .git/modules/vendor/lib

丢弃文件的所有未暂存改动。等价于 git restore <file>。不可撤销 —— 工作区状态没有 reflog。

⚠ 常见坑: 没有提示、没有确认、没有备份。不确定就先 git stash。

git checkout -- broken.ts

git restore broken.ts

直接 checkout 了某个 commit/tag（如 git checkout v1.0），这里产生的提交在你回到分支时会“丢失”，除非创建一个分支。

⚠ 常见坑: 不小心在 detached HEAD 里改了东西，先 git reflog 找回，立即 git branch save-me <sha> 收住。

git switch -c new-branch

git reflog

git branch save-me HEAD@{0}

merge 中冲突时：编辑每个文件里的 <<<<<<< / ======= / >>>>>>> 标记，git add 已解决的文件，然后 git commit（或 git merge --continue）。

⚠ 常见坑: 忘记 git add 已解决的文件，merge 不会被算完成 —— commit 报 “you have unmerged paths”。

git status

git add resolved.ts

git commit

git merge --abort

错误的 reset/rebase/删分支后，git reflog 会列出每一次 HEAD 移动。找到目标 SHA 然后 git reset --hard <sha> 或 git branch rescue <sha>。

⚠ 常见坑: reflog 会过期（可达 90 天，不可达 30 天）。越早恢复越好。

git reflog

git branch rescue HEAD@{3}

git reset --hard HEAD@{5}

强推覆盖了同事的工作：让同事用自己本地的 reflog 找回旧 SHA 并强推回去（远端被覆盖了，本地还在）。

⚠ 常见坑: GitHub 在悬挂对象的 GC 里大约保留 14 天 —— 有时能通过 API 找回。强推请永远 --force-with-lease。

# on a teammate's machine still holding the old SHAs:

git push --force-with-lease origin <sha>:main

不小心提交了密钥。git rm 只是“以后没了”。要从全部历史里清掉，用 git filter-repo（现代推荐）或 BFG Repo Cleaner。

⚠ 常见坑: 清理完务必旋转那个密钥 —— 已经克隆过的人本地还有。清理后强推干净历史。

git filter-repo --invert-paths --path secrets/key.pem

git push --force-with-lease origin --all

试图合并/拉取两个没有共同祖先的仓库（如克隆后又重新 init）。确定要合并就加 --allow-unrelated-histories。

git pull origin main --allow-unrelated-histories