Git 速查表 — 按任务分类的命令

git config set --global user.name "Ana Lee"
git config set --global user.email "ana@example.com"

传统写法：git config --global user.name "Ana Lee"

会记录在你的每一次提交中。请使用 Git 托管平台上登记的邮箱，这样提交才能关联到你的账号。

git config set --global init.defaultBranch main

传统写法：git config --global init.defaultBranch main

不设置的话，git init 仍会把第一个分支命名为 master（并输出一条提示）。

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

传统写法：git config --global core.editor "code --wait"

任何会阻塞直到文件关闭的命令都可以："nano"、"vim"、"subl -n -w"。

git config set --global core.autocrlf true  # Windows
git config set --global core.autocrlf input  # macOS, Linux

传统写法：git config --global core.autocrlf true

提交时统一为 LF，在 Windows 上检出时转为 CRLF。团队协作时，用包含 "* text=auto" 的 .gitattributes 文件比每人单独设置更可靠。

git --version

git switch 和 git restore 需要 2.23+，git config 子命令需要 2.46+。

git init
git init -b main  # name the first branch

会创建 .git 目录。在第一次提交前加好 .gitignore，避免构建产物和密钥被提交进去。

git clone https://github.com/owner/repo.git
git clone git@github.com:owner/repo.git my-folder

下载完整历史，并把远程仓库设为 "origin"。第二种写法使用 SSH，并指定自定义文件夹名。

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

跳过历史记录，适合 CI 和大型仓库。之后可用 git fetch --unshallow 补全历史。

git remote add origin git@github.com:owner/repo.git
git push -u origin main

先在托管平台上创建空仓库（或使用下文的 gh repo create）。-u 会把 origin/main 记为上游分支。

git status
git status -s  # short form

列出已暂存、未暂存和未跟踪的文件，并提示下一步可用的命令。

git add file.txt
git add .  # everything in this folder and below

git add -A 还会暂存整个仓库中的文件删除。

git add -p file.txt

逐个处理每处改动（"hunk"）：y 暂存，n 跳过，s 拆分，e 编辑。

git commit -m "Add login form"
git commit -am "Fix typo"  # stage tracked files and commit

-a 会自动包含已跟踪文件的修改和删除，但不包括新文件。

git mv old.txt new.txt
git rm file.txt

两者都会自动暂存改动。Git 根据内容识别重命名，所以直接 mv 再 git add 也可以。

git rm --cached .env
echo ".env" >> .gitignore

从下一次提交起将其移出仓库。它仍保留在之前的提交中：如果其中有密钥，请更换密钥。

git branch
git branch -a  # include remote branches
git branch -vv  # show upstream and ahead/behind

当前分支以 * 标记。

git switch -c feature/login

传统写法：git checkout -b feature/login

从当前提交开始；如需从别处创建，加上起点：git switch -c hotfix origin/main。

git switch main
git switch -  # back to the previous branch

传统写法：git checkout main

如果只存在 origin/feature，git switch feature 会自动创建对应的本地跟踪分支。

git branch -m new-name  # current branch
git branch -m old-name new-name

只重命名本地分支。要同时重命名远程分支，请看下一条。

git branch -m old-name new-name
git push -u origin new-name
git push origin --delete old-name

远程没有重命名操作：推送新名称，再删除旧名称。基于旧名称的未合并拉取请求可能会被关闭；使用 GitHub 网页上的重命名按钮则会自动把它们指向新分支。

git branch -u origin/main
git push -u origin HEAD  # push current branch and track it

传统写法：git branch --set-upstream-to=origin/main

不带参数的 git pull 和 git push 使用的就是上游分支。

git switch --detach a1b2c3d
git switch -c rescue  # keep work made there

传统写法：git checkout a1b2c3d

分离状态下的提交不属于任何分支；切走之前先创建分支，否则只能通过 reflog 找回。

git switch main
git merge feature/login
git merge --no-ff feature/login  # always create a merge commit

能快进时会快进；--no-ff 会在历史中保留分支结构。

git merge --squash feature/login
git commit -m "Add login"

暂存合并后的全部改动，但不记录合并；之后该分支不会被标记为已合并。

git status  # list conflicted files
# edit the files, remove <<<<<<< ======= >>>>>>> markers
git add file.txt
git commit  # or: git rebase --continue

整体采用某一方：git restore --ours file.txt 或 --theirs。变基时 "ours" 指的是被变基到的目标分支，与合并时正好相反。

git pull --rebase
git config set --global pull.rebase true  # make it the default

把你的本地提交变基到拉取到的内容之上。

git cherry-pick a1b2c3d
git cherry-pick -x a1b2c3d  # note the source in the message

创建一个包含相同改动的新提交。范围写法：git cherry-pick A..B（不含 A）。

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

set-url 可把克隆从 HTTPS 切换到 SSH（或指向改名后的仓库）。

git fetch
git fetch --prune  # also drop deleted remote branches

只更新 origin/*；你的分支保持不变。

git pull

相当于 git fetch 加 merge（如果设置了 pull.rebase，则是 rebase）。

git push
git push -u origin HEAD  # first push of a new branch
git config set --global push.autoSetupRemote true

开启 push.autoSetupRemote（Git 2.37+）后，在新分支上直接 git push 就会自动设置上游。

git remote add upstream https://github.com/original/repo.git
git fetch upstream
git switch main
git merge upstream/main

也可以用 GitHub CLI：gh repo sync。

git revert a1b2c3d
git revert HEAD  # the latest commit

新增一个反向提交来抵消旧提交，不会改动其他人的历史。这是共享分支上安全的撤销方式。

git revert -m 1 <merge-sha>

-m 1 保留第一个父提交（通常是 main）。以后要重新合并该分支，需要先撤销这次 revert。

git restore --staged file.txt
git restore --staged .  # everything

传统写法：git reset HEAD file.txt

改动仍留在工作区，只是撤销了暂存。

git restore file.txt  # deletion not committed
git restore --source=a1b2c3d~1 file.txt  # deleted in commit a1b2c3d

传统写法：git checkout a1b2c3d~1 -- file.txt

用 git log --diff-filter=D -- file.txt 找到删除它的提交。

git reflog
git branch rescued a1b2c3d

reflog 记录了 HEAD 去过的每个位置。找到出错前的 SHA，在上面创建一个分支即可。

git stash
git stash push -m "half-done login"
git stash -u  # include untracked files

保存已跟踪文件的改动并清理工作区，方便你切换分支。

git stash pop  # apply and drop
git stash apply stash@{1}  # apply, keep the stash

可能出现冲突；使用 pop 时，如果应用失败，stash 会被保留。

git stash list
git stash show -p stash@{0}

最新的在前；stash@{0} 是最近一次。

git stash push -- src/login.ts
git stash push --staged  # only what is staged (2.35+)

指定路径的 stash 不会动其他文件。

git stash branch feature/login stash@{0}

在 stash 时所在的提交上创建分支，应用并删除该 stash；可避免冲突。

git log --oneline --graph --all

每个提交一行，并显示分支结构。在很旧的 Git 上需加 --decorate 才能看到分支名。

git log --follow -p -- path/file.txt

--follow 可跨越重命名继续追踪；-p 显示每次改动。

git log -S "functionName" --oneline
git log -G "regex" --oneline

-S 查找出现次数发生变化的提交；-G 用正则表达式匹配任意改动的行。

git log --author="Ana" --since="2 weeks ago" --oneline

还有 --until、按提交信息筛选的 --grep="fix"，以及 main..feature（在 feature 上但不在 main 上的提交）。

git show a1b2c3d
git show a1b2c3d:path/file.txt

第二种写法会输出文件在该提交中的内容，不会影响你的工作副本。

git diff  # unstaged
git diff --staged  # staged, i.e. what will be committed

--stat 按文件汇总；--word-diff 更适合文字内容。

git diff main...feature  # changes on feature since it branched
git diff main feature  # the two tips directly

三个点表示与合并基础比较，也就是拉取请求中显示的内容。

git blame -L 10,20 path/file.txt

加 -w 忽略空白，加 -C 追踪从其他文件移动过来的行。

git bisect start
git bisect bad  # current commit is broken
git bisect good v1.4.0  # this one worked
# test, then mark each step good or bad
git bisect reset

二分查找：大约 log2(n) 步。git bisect run ./test.sh 可以自动完成。

git grep -n "TODO"

在大型仓库中比 grep 更快，并会跳过被忽略的文件。加上提交即可搜索旧版本。

git tag -a v1.2.0 -m "Release 1.2.0"
git tag -a v1.1.1 a1b2c3d -m "Hotfix"  # tag an older commit

附注标签（-a）会保存作者、日期和说明，发布版本建议用它。只写 git tag v1.2.0 会创建轻量标签。

git push origin v1.2.0
git push --follow-tags  # annotated tags reachable from pushed commits

git push 默认不推送标签。git push --tags 会推送所有标签，包括本地无关的标签。

git tag -l "v1.*"
git describe --tags

describe 输出最近的标签及其后的提交数，例如 v1.2.0-3-ga1b2c3d。

git submodule add https://github.com/owner/lib.git vendor/lib
git commit -m "Add lib submodule"

在 .gitmodules 中记录 URL，并锁定另一个仓库的某个确切提交。

git clone --recurse-submodules <url>
git submodule update --init --recursive  # already cloned

不运行这一步，子模块文件夹就是空的。

git submodule update --remote
git commit -am "Bump submodules"

拉取每个子模块所跟踪的分支；然后在父仓库中提交新的锁定版本。

git worktree add ../repo-hotfix hotfix
git worktree add -b review ../repo-review origin/main

共享同一仓库的第二个工作目录；无需 stash，也无需再克隆一份。

git worktree list
git worktree remove ../repo-hotfix
git worktree prune  # forget folders deleted by hand

如果工作树中有未提交的改动，remove 会拒绝执行（用 --force 强制）。

git clean -n -d

运行 git clean -f 之前一定要先运行这条。

git branch --merged main
git branch -d branch-a branch-b

先检查列表；-d 会拒绝删除未合并的分支，所以可以放心尝试。

git fetch --prune
git config set --global fetch.prune true

删除那些在服务器上已被删除的分支对应的 origin/* 引用。

git maintenance start
git gc

maintenance start 会安排后台的预取、commit-graph 和重新打包任务；gc 则立即打包对象并清理不可达对象。

git config list --show-origin

传统写法：git config --list --show-origin

显示系统、全局和仓库级别的配置值，以及每项所在的文件。

git config set --global alias.st "status -s"
git config set --global alias.lg "log --oneline --graph --all"

传统写法：git config --global alias.st "status -s"

之后即可使用 git st 和 git lg。以 ! 开头可运行 shell 命令：alias.root "!pwd"。

git config set --global pull.rebase true
git config set --global push.autoSetupRemote true
git config set --global rerere.enabled true
git config set --global merge.conflictStyle zdiff3
git config set --global diff.algorithm histogram

传统写法：git config --global pull.rebase true

pull 时变基；首次推送时自动设置上游（2.37+）；记住冲突的解决方式；冲突中显示共同祖先（2.35+）；更清晰的 diff。

git config set --global core.excludesFile ~/.gitignore_global

传统写法：git config --global core.excludesFile ~/.gitignore_global

用于系统和编辑器产生的杂项文件（.DS_Store、.idea/）。项目相关的规则应写在仓库的 .gitignore 中。

gh auth login
gh auth setup-git  # let git use gh for HTTPS credentials

会打开浏览器或使用令牌登录；支持 github.com 和 GitHub Enterprise。

gh repo create my-app --private --source=. --push

创建仓库，将其添加为 origin，并推送当前分支。

gh repo clone owner/repo

如果是 fork，还会把父仓库添加为 upstream 远程仓库。

gh pr create --fill
gh pr create --draft --title "WIP: login" --body "…"

--fill 使用提交信息作为标题和正文。

gh pr checkout 123

拉取 PR 分支（包括来自 fork 的）并切换过去。

gh pr list
gh pr view 123 --web
gh pr merge 123 --squash --delete-branch

gh pr status 显示与你相关的 PR。

gh issue create --title "Bug: …" --body "…"
gh issue list --assignee @me

gh issue view 42 --comments 可在终端中阅读讨论。

gh run list
gh run watch

gh run view --log-failed 只输出失败的步骤。