丢弃工作区里对该文件的修改，恢复成暂存区的样子。

旧版写法是 git checkout -- <file>。

丢弃当前目录及子目录下所有未暂存的修改。

把文件撤出暂存区，改动仍留在工作区。

旧版写法是 git reset HEAD <file>。

把某个文件恢复成两次提交之前的内容。

旧写法，等价于 git restore <file>。

和切分支共用一个命令是 restore/switch 被拆出来的原因。

撤销最近一次提交，改动保留在暂存区。

「commit 完发现少提交了一个文件」最常用的一条。

撤销最近一次提交，改动退回工作区（--mixed 是默认行为）。

撤销最近一次提交并丢弃全部改动。

提交本身能用 reflog 找回，但没提交过的改动找不回。

修改最近一次提交的信息和内容（暂存区里的东西会一起并进去）。

把暂存区补进上一次提交，保持原提交信息不变。

生成一个内容相反的新提交来抵消指定提交，历史不被改写。

已经推送出去的提交要撤销，用这个而不是 reset。

撤销一次合并提交，-m 1 表示保留第一个父提交（通常是主线）。

列出 HEAD 的所有移动记录，包括被 reset 掉的提交。

误操作之后的第一反应就该是它。默认保留 90 天。

按 reflog 里查到的哈希，把分支拉回那个时刻。

把指定提交的改动复制一份到当前分支。

同上，但只放进暂存区不自动提交，方便改完再提交。

预演：列出会被 git clean 删掉的未跟踪文件，什么都不删。

执行 clean 之前先跑这条，成本为零。

删除所有未跟踪的文件和目录。

连 .gitignore 里忽略的一起删（node_modules、dist、.env 都会没）。

把文件移出版本库但保留在本地磁盘上。

补写 .gitignore 之后清理已被跟踪的文件用它。

改写历史后推送。远端若有你没见过的新提交会拒绝推送。

任何时候都该用它代替 --force：--force 会直接覆盖掉别人刚推的提交。

看当前有哪些改动、在哪个分支、和上游差几个提交。

短格式输出，一行一个文件，顶部带分支信息。

把指定文件的改动放进暂存区。

暂存当前目录及以下的所有改动。

暂存整个仓库的所有改动，包括删除的文件。

交互式逐块挑选要暂存的内容。

把一次大改动拆成几个语义清晰的提交，靠的就是这条。

把暂存区的内容提交。

跳过 add 直接提交。

只对已跟踪的文件生效，新建的文件不会被带上。

跳过 pre-commit / commit-msg 钩子。

钩子卡住紧急修复时才用，别成为习惯。

工作区 与 暂存区 的差异（还没 add 的部分）。

暂存区 与 上次提交 的差异（已 add、待提交的部分）。

工作区 + 暂存区 与上次提交的全部差异。

两个提交、分支或标签之间的差异。

只看改了哪些文件、各增删多少行。

按词而不是按行对比。

改中文文案、Markdown 文档时比默认的整行高亮清楚得多。

检查是否引入了行尾空格、空白错误。

列出本地分支，当前分支带 *。

列出本地 + 远程跟踪分支。

列出分支并显示各自的上游分支和领先/落后提交数。

切换到已有分支。

基于当前位置新建分支并切过去。

旧写法 git checkout -b <new>。

从指定提交、分支或标签新建分支。

切回上一个待过的分支。

切到某个具体提交（游离 HEAD 状态），用于临时查看历史版本。

旧写法：新建并切换分支。

删除已经合并过的本地分支。

强制删除本地分支，不检查是否已合并。

删错了用 git reflog 查到哈希还能重建。

重命名当前分支。

列出已经合并进当前分支的分支。

配合 xargs 批量清理已合并的特性分支。

列出还没合并进当前分支的分支。

删除远程分支。

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

即使能快进也强制生成一个合并提交。

想在历史里保留「这是一条特性分支」的形状时用。

把整条分支的改动压成一份放进暂存区，由你提交成一个提交。

冲突处理到一半，放弃合并回到合并前。

把当前分支独有的提交，逐个重放到 base 之上。

交互式整理最近 5 个提交：压缩(squash)、改序、改信息、删除。

解决完当前冲突，继续变基。

跳过当前这个提交，继续变基。

放弃变基，回到开始之前的状态。

把分支从旧基上摘下来接到新基上，用于分支开错了地方。

拉取远端更新并把本地提交变基到其上，不产生多余的合并提交。

冲突时直接采用当前分支这一版。

rebase 期间 ours/theirs 的含义是反的：ours 指的是被变基到的那个基。

冲突时直接采用对方分支那一版。

记住你解决过的冲突，下次遇到一模一样的冲突自动套用。

长期维护的分支反复 rebase 时省掉大量重复劳动。

调用配置好的图形化工具解决冲突。

看远程仓库的名字和地址。

添加一个远程仓库。

修改远程地址。

HTTPS 换 SSH、换域名、换托管平台都用它。

重命名远程仓库。

清掉远端已删除分支在本地留下的跟踪引用。

拉取远端最新数据，但不改动你的工作区和分支。

拉取所有远程仓库，并顺手清理已删除的远程分支引用。

拉取并合并（等于 fetch + merge）。

把当前分支推送到其上游分支。

推送并建立上游关联，之后直接 git push / git pull 即可。

把本地标签一起推送到远端。

不克隆就查看远端有哪些分支和标签。

验证仓库地址对不对、权限通不通，比 clone 快得多。

一行一提交的分支拓扑图，看清分支怎么分怎么合。

值得配个别名，比如 git lg。

只看最近 10 条提交。

按时间筛选提交。

只看某个人的提交。

找出哪次提交引入或删除了这段字符串（pickaxe 搜索）。

排查「这行诡异代码是哪来的」最快的路子。

同 -S，但按正则匹配 diff 内容。

看某个文件历次改动的完整 diff。

追溯文件历史，跨过重命名继续往前查。

逐行显示这一行是谁在哪次提交改的。

只对 10–20 行做 blame。

blame 时忽略空白变化并追踪代码搬迁。

避免把「格式化全文件」的那个人算成所有代码的作者。

看某次提交的完整信息和 diff。

看某次提交时该文件的全文内容。

按作者统计提交数量，从多到少排。

开始二分查找，定位是哪次提交引入了问题。

标记当前版本有问题 / 标记某个版本是好的，Git 自动二分。

结束二分查找，回到原来的分支。

在仓库里搜索。

只搜被跟踪的文件，比 grep -r 快且不会翻进 node_modules。

用最近的标签加偏移量描述当前提交，常用于生成版本号。

把工作区和暂存区的改动收起来，回到干净状态。

连未跟踪的新文件一起收起来。

不加 -u 的话，新建的文件会被留在原地，切分支后还在。

只收指定文件，并给这条储藏加个说明。

列出所有储藏。

取出最近一条储藏并从列表里删除。

取出指定储藏但保留在列表里（可以往多个分支各应用一次）。

看最近一条储藏里具体改了什么。

删掉指定储藏。

清空所有储藏。

储藏不在任何分支上，清掉之后基本找不回来。

基于当初储藏时的那个提交新建分支并应用储藏。

储藏放太久、代码已经跟不上主线时用这条，能避开冲突。

列出所有标签。

打一个轻量标签（只是个指针，不记录作者和时间）。

打一个附注标签，带作者、日期和说明。

正式发版用附注标签，git describe 默认也只认它。

给一个历史提交补打标签。

按通配符筛选标签。

删除本地标签。

推送单个标签。

git push 默认不带标签，漏了这步远端就没有。

删除远程标签。

设置全局提交者名字。

设置全局提交者邮箱。

公司仓库和个人仓库邮箱不同时，在仓库内去掉 --global 单独设。

新建仓库时的默认分支名。

让中文文件名正常显示。

不设的话 git status 里中文文件名会显示成 \344\275\240 这样的八进制转义。

提交时把 CRLF 转成 LF，检出时不转（macOS / Linux 推荐）。

Windows 上用 true。跨平台协作的换行符问题基本都出在这。

pull 默认用变基而不是合并，历史更干净。

给长命令起别名。

列出所有生效的配置，并显示每一条来自哪个文件。

排查「我明明设了怎么不生效」就用它。

用 VS Code 编辑提交信息。

记住 HTTPS 凭证。

明文存在 ~/.git-credentials，公用机器上别开；macOS 用 osxkeychain 更合适。

在当前目录初始化一个新仓库。

初始化并指定初始分支名。

克隆远程仓库。

浅克隆，只拿最近一次提交。

大仓库只是想看看代码时能快一个数量级，但不能推送历史相关操作。

只克隆指定的一个分支。

部分克隆：先只要提交历史，文件内容按需拉取。

比浅克隆保留更多信息，适合需要查历史的巨型仓库。

克隆时把子模块一起拉下来。

看仓库里的对象数量和实际占用空间。

垃圾回收：打包松散对象、清理过期引用。

深度重打包并立刻清理不可达对象。

会让 reflog 里的东西真正消失，跑之前先确认没有要找回的提交。

检查仓库完整性并找出悬空的提交和对象。

reflog 也没记录的情况下，这是最后一根稻草。

注册后台定时维护任务，自动做 gc、预取等。

给同一个仓库再开一个工作目录，检出另一个分支。

临时要看另一个分支又不想 stash 手上的活，比 clone 一份省空间。

列出所有工作目录。

移除一个工作目录。

只检出仓库里的部分目录，适合单体大仓库。

从整个历史里彻底删除某个文件或目录。

需要单独安装 git-filter-repo。会重写所有提交哈希，协作者必须重新克隆。

把当前版本打包成 zip，不含 .git 目录。

添加一个子模块。

初始化并拉取所有子模块（含嵌套）。

克隆时忘了 --recurse-submodules，补这一条。

把子模块更新到它自己远端分支的最新提交。

对每个子模块执行同一条命令。

卸载子模块的工作目录。

在本机启用 Git LFS。

把某类大文件交给 LFS 管理。

只对之后新增的文件生效，已经在历史里的大文件还得用 filter-repo 清。

列出当前由 LFS 管理的文件。