git 命令速查表
$ git config --global init.defaultBranch main # 设置本地默认分支为 main$ git config --global core.ignorecase false # 设置文件名大小写敏感 # [注意] macOS 默认不敏感，跨平台协作慎用$ git config --global safe.directory "*" # 忽略目录安全限制 # [注意] 降低所有权校验，共享机器慎用$ git config --list # 查看所有配置$ git config --global -l # 查看全局配置$ git config --local -l # 查看当前仓库配置$ git config --list --show-origin # 查看配置及其所在文件$ git config --global user.name "name" # 设置全局用户名$ git config --global user.email "example@example.com" # 设置全局邮箱$ git config --local user.name "name" # 设置当前仓库用户名$ git config --local user.email "example@example.com" # 设置当前仓库邮箱$ git config user.name # 查看用户名配置$ git config user.email # 查看邮箱配置$ git config --unset --global user.name # 删除全局用户名配置$ git config --unset --global user.email # 删除全局邮箱配置$ git config --global credential.helper store # 永久记住账号密码 # [注意] 明文存储，公共设备勿用$ git config --global credential.helper cache # 临时记住账号密码（默认 15 分钟）初始化与克隆
Section titled “初始化与克隆”$ git init # 在当前目录初始化仓库$ git init --bare # 创建裸仓库（仅含 .git 内容）$ git init <path> # 新建目录并初始化仓库$ git clone <url> # 克隆远程仓库$ git clone <url> <dir> # 克隆并重命名本地目录$ git clone -b <branch> <url> # 克隆指定分支$ git status # 查看工作区与暂存区状态$ git status -s # 以短格式输出状态$ git status --ignore-submodules # 忽略子模块状态$ git status --ignored # 显示被忽略的文件$ git diff # 查看工作区与暂存区差异$ git diff --staged # 查看暂存区与最新 commit 差异（同 --cached）$ git diff <branch1> <branch2> # 比较两个分支差异$ git diff <commit> -- <file> # 查看指定 commit 中某文件的差异$ git add -A # 暂存所有改动（含删除）$ git add . # 暂存当前目录所有改动$ git add ./README.md # 暂存指定文件$ git add 1.txt 2.txt # 暂存多个文件$ git commit -m "changes log" # 提交并附带描述信息$ git commit README.md -m "message" # 只提交指定文件$ git commit -v # 提交并显示 diff$ git commit --allow-empty-message # 允许空提交信息$ git commit --amend -m "new message" # 修改上一次提交信息 # [注意] 已推送需配合 force push，协作分支慎用$ git commit --no-verify -m "message" # 跳过 pre-commit 钩子验证 # [注意] 会绕过 CI/检查，仅在明确需要时使用$ git push # 推送当前分支到上游$ git push origin <local-branch>:<remote-branch> # 推送本地分支到远端指定分支$ git push -u origin main # 推送并设置上游分支（缩写 --set-upstream）$ git push -f origin main # 强制推送（缩写 --force） # [注意] 覆盖远程历史，共享分支慎用$ git fetch # 拉取远程所有分支更新$ git fetch origin <remote-branch>:<local-branch> # 拉取远程分支到本地分支 # [注意] 可能覆盖本地同名分支$ git pull # 拉取并合并远程更新$ git pull --rebase # 拉取并以 rebase 方式整合$ git pull origin <branch> # 拉取指定远程分支$ git log # 查看完整提交历史$ git log -2 # 查看最近 N 次提交$ git log -p -2 # 查看最近 N 次提交及 diff$ git log -i --grep="fix: issue-28" # 按 commit message 搜索（-i 忽略大小写）$ git log -S "alert(1)" # 搜索引入/删除指定代码的提交$ git log --author=<name> # 查看指定作者的提交$ git log README.md # 查看指定文件的提交历史$ git log --merges # 只显示合并提交$ git log --graph --oneline --all # 图形化查看所有分支历史$ git log --reverse # 按时间正序查看历史$ git shortlog # 按贡献者分组输出日志$ git shortlog -sn # 统计各作者提交数量$ git shortlog -n # 按提交数量排序并输出 message$ git shortlog -e # 以邮箱格式化输出贡献度$ git reflog # 查看引用日志（含 reset/rebase 等操作记录）$ git branch # 查看本地分支$ git branch -a # 查看所有分支（含远程）$ git branch -r # 查看远程分支$ git branch -v # 查看本地分支及最近提交$ git branch -vv # 查看本地与远程分支映射关系$ git branch --help # 查看 branch 帮助文档$ git checkout <branch> # 切换到指定分支$ git checkout - # 切换到上一个分支$ git checkout -f main # 强制切换（丢弃未保存修改） # [注意] 未提交改动将丢失$ git checkout -b <branch> # 创建并切换分支$ git checkout -B <branch> # 强制创建分支（不切换） # [注意] 已存在分支会被重置$ git checkout -t upstream/main # 跟踪远程分支并切换$ git switch <branch> # 切换到指定分支（Git 2.23+）$ git switch - # 切换到上一个分支$ git switch -f main # 强制切换 # [注意] 未提交改动将丢失$ git switch -c <branch> # 创建并切换分支$ git switch -C <branch> # 强制创建分支（不切换） # [注意] 已存在分支会被重置$ git switch -t upstream/main # 跟踪远程分支并切换$ git checkout -b <branch> origin/<branch> # 拉取远程分支并建立跟踪$ git branch --set-upstream-to=origin/<branch> <branch> # 设置本地分支跟踪远程分支分支创建与删除
Section titled “分支创建与删除”$ git branch <branch> # 创建分支（不切换）$ git branch -f <branch> # 强制创建/重置分支指针 # [注意] 未合并提交可能丢失$ git branch -d <branch> # 删除已合并的本地分支$ git branch -D <branch> # 强制删除本地分支（缩写 --delete --force） # [注意] 未合并改动将丢失$ git push origin --delete <branch> # 删除远程分支 # [注意] 影响所有协作者，删除前确认$ git push origin :<branch> # 删除远程分支（旧写法） # [注意] 影响所有协作者，删除前确认$ git branch -m <new-branch> # 重命名当前分支$ git branch -M <new-branch> # 强制重命名当前分支$ git branch -m <old-branch> <new-branch> # 重命名指定分支$ git push -u origin <new-branch> # 推送重命名后的分支$ git stash # 保存当前工作区与暂存区改动$ git stash save "修改了 issue-28 Bug" # 保存并添加注释（推荐）$ git stash -u # 保存时包含未追踪文件$ git stash list # 查看 stash 列表$ git stash pop # 恢复最近一次 stash 并从列表移除$ git stash pop stash@{1} # 恢复指定 stash$ git stash pop --index # 恢复时连同暂存区状态一并还原$ git stash apply # 恢复 stash 但保留列表条目$ git stash drop # 删除最近一次 stash # [注意] 无法恢复$ git stash drop stash@{0} # 删除指定 stash # [注意] 无法恢复$ git stash clear # 清空所有 stash # [注意] 无法恢复恢复文件 restore
Section titled “恢复文件 restore”$ git restore <file> # 丢弃工作区改动（恢复为暂存区或 HEAD）$ git restore . # 丢弃当前目录所有工作区改动$ git restore --staged <file> # 取消暂存，保留工作区改动$ git restore --staged . # 取消暂存当前目录所有文件$ git restore --staged --worktree <file> # 同时重置暂存区与工作区为 HEAD$ git restore --source=<branch> <file> # 从指定分支恢复文件到工作区 # [注意] 会覆盖工作区中对应文件$ git restore --source=<commit> <file> # 从指定 commit 恢复文件到工作区 # [注意] 会覆盖工作区中对应文件$ git restore --source=<commit> --staged <file> # 从指定 commit 恢复并暂存$ git merge <branch> # 合并指定分支到当前分支$ git merge --no-ff <branch> # 非快进合并，保留合并节点$ git merge --squash <branch> # 将分支改动压成一个提交 # [注意] 不会自动提交，需手动 commit$ git merge --abort # 中止合并并恢复原状态变基 rebase
Section titled “变基 rebase”$ git rebase main # 将当前分支变基到 main 之上 # [注意] 已推送分支变基后需 force push$ git rebase origin/main # 将当前分支变基到远程 main 之上 # [注意] 已推送分支变基后需 force push$ git rebase -i HEAD~3 # 交互式变基最近 3 个提交（缩写 --interactive） # [注意] 会改写历史，共享分支慎用$ git rebase --continue # 解决冲突后继续变基$ git rebase --abort # 中止变基并恢复原状态$ git rebase --skip # 跳过当前提交继续变基 # [注意] 被跳过的提交不会进入当前分支$ git pull --rebase # 拉取远端并以 rebase 整合（避免多余 merge commit）拣选 cherry-pick
Section titled “拣选 cherry-pick”$ git cherry-pick <commit> # 将指定提交应用到当前分支 # [注意] 同一 commit 重复拣选可能产生重复改动$ git cherry-pick <commit1> <commit2> # 依次拣选多个提交$ git cherry-pick -n <commit> # 拣选但不自动提交（缩写 --no-commit）$ git cherry-pick -x <commit> # 拣选并在 message 中追加原 commit 引用$ git cherry-pick --continue # 解决冲突后继续拣选$ git cherry-pick --abort # 中止拣选并恢复原状态$ git reset --soft HEAD^ # 撤销最近一次 commit，保留暂存区$ git reset --mixed HEAD^ # 撤销 commit 与 add，保留工作区（默认）$ git reset --hard HEAD^ # 撤销 commit、add 与工作区改动 # [注意] 未提交改动无法恢复$ git reset --hard HEAD^^ # 回退上两个版本 # [注意] 未提交改动无法恢复$ git reset --hard <commit> # 回退到指定 commit # [注意] 未提交改动无法恢复$ git reset --hard origin/main # 与远程 main 完全对齐，丢弃本地改动 # [注意] 本地未推送提交将全部丢失$ git revert HEAD^ # 新建提交来撤销指定 commit（保留历史）$ git revert <commit> # 撤销指定 commit$ git revert HEAD^ --no-edit # 撤销并跳过编辑提交信息$ git revert --abort # 中止 revert 操作$ git push -f # 强制推送（reset 后同步远程时使用） # [注意] 覆盖远程历史，共享分支慎用$ git remote # 查看远程仓库名称（默认 origin）$ git remote -v # 查看远程仓库地址$ git remote -vv # 查看远程仓库详细映射$ git remote add <remote> <url> # 添加远程仓库$ git remote show <remote> # 查看指定远程仓库信息$ git remote rename <old-remote> <new-remote> # 重命名远程仓库$ git remote remove <remote> # 移除远程仓库 # [注意] 仅删除本地引用，不影响远端$ git remote set-url origin <url> # 修改远程仓库地址$ git remote prune origin # 清理已删除的远程分支引用$ git push <remote> # 推送到指定远程仓库$ git tag # 列出本地标签$ git tag -l # 列出标签（同 --list）$ git ls-remote --tags origin # 查看远程标签$ git tag <tag> # 在当前 HEAD 创建轻量标签$ git tag -a <tag> -m "tag message" # 创建附注标签$ git push origin <tag> # 推送单个标签$ git push origin --tags # 推送所有本地标签$ git tag -d <tag> # 删除本地标签 # [注意] 已推送 tag 需同步删除远程$ git push origin :refs/tags/<tag> # 删除远程标签 # [注意] 影响依赖该 tag 的发布流程$ git show <tag> # 查看标签详情工作树 worktree
Section titled “工作树 worktree”$ git worktree list # 列出所有工作树$ git worktree add <path> <branch> # 在指定路径检出分支$ git worktree add -b <branch> <path> # 新建分支并在指定路径检出$ git worktree add --detach <path> <commit> # 以 detached HEAD 检出指定 commit$ git worktree remove <path> # 删除工作树$ git worktree remove -f <path> # 强制删除工作树 # [注意] 未提交改动将丢失$ git worktree prune # 清理已不存在目录的工作树记录$ git worktree move <worktree> <new-path> # 移动工作树目录