提交早了、写错了、提错分支了
搜「撤销」或直接看「回退与撤销」分组，先分清「还没推送」（reset / --amend）和「已经推送」（revert）两种情况，再挑命令。「常见组合」里有「在 main 上提交了想挪到新分支」这类完整配方。
加载中…
加载工具中…
使用指南
Git 命令速查：149 条按场景分组，可搜索、复制、收藏
Git 命令速查是一张可以直接用的表：149 条命令按「初始化与配置、日常提交、分支、合并与变基、回退与撤销、远程协作、stash、标签、子模块与工作树、查历史与排错、忽略与属性」十一个场景分组，每条给一句中文解释、一段能直接粘贴的示例，以及「注意 / 危险」两级风险标注——会丢未提交改动或改写已共享历史的命令一眼就能认出来。
更新于 2026-09-094 个来源约 10 分钟读完
工具说明
Git 命令速查是一张可以直接用的表：149 条命令按「初始化与配置、日常提交、分支、合并与变基、回退与撤销、远程协作、stash、标签、子模块与工作树、查历史与排错、忽略与属性」十一个场景分组，每条给一句中文解释、一段能直接粘贴的示例，以及「注意 / 危险」两级风险标注——会丢未提交改动或改写已共享历史的命令一眼就能认出来。
它面向三种时刻：记得要做什么但忘了命令怎么拼（搜「撤销 commit」「删除远程分支」）；知道命令却不确定它会不会把东西弄丢（看危险等级和备注）；以及第一次接触 Git、想弄明白 add、commit、push 之间到底在搬什么（看页首的四个区域图和下方的操作示意图）。
页面底部还有一个纯内存的 Git 模拟终端：支持 30 多个常用子命令，右侧提交图随每一条命令实时变化，附 10 个从「第一次提交」到「解决合并冲突」的练习关卡。它不是真正的 Git，也不会访问你的电脑或网络，但语义按官方手册实现，练完可以直接迁移到真机。
使用步骤
- 搜索在顶部输入框敲命令名或你想做的事（如「回退」「强推」「删除分支」），支持多个词以空格分隔、全部命中才显示；结果按原分组排列。
- 按场景浏览点分组 chips 只看某一类，或点「四个区域」下方的分组目录跳到对应位置；勾选「只看有风险的命令」可以在执行前快速复查。
- 复制点击蓝色命令文本或右侧的复制图标复制命令，第二个图标复制示例；「常见组合」里可整段复制一条配方。
- 收藏点星标把常用命令固定到页面顶部的「我的收藏」，收藏保存在本机浏览器（localStorage），换设备不同步。
- 练习滚到「练习终端」，选一关、按目标敲命令；每条命令后自动判定，卡住时点「提示」或「参考答案」，「重置」回到关卡初始状态。
输入与输出示例
在搜索框输入「撤销 commit」，得到的是「回退与撤销」分组里这几条（节选）：
在模拟终端里完成第 4 关「撤销最近一次提交但保留改动」的过程：
git reset --soft HEAD~1 撤销最近一次提交，改动保留在暂存区 注意
git reset HEAD~1 撤销最近一次提交，改动回到工作区未暂存
git reset --hard <commit> 分支指针、暂存区、工作区全部回到 commit 危险
git revert <commit> 生成一个新提交来抵消改动，历史不变，可安全推送user@toolun-lab:~/project (main)$ git log --oneline
7f3a1c2 (HEAD -> main) wip: 乱七八糟的提交
2b9e0d4 init: add README
user@toolun-lab:~/project (main)$ git reset --soft HEAD~1
HEAD 现在位于 2b9e0d4 init: add README
--soft：只移动分支指针，暂存区和工作区都保留（被撤销的提交内容处于已暂存状态）
提示：被丢弃的提交 7f3a1c2 仍可通过 git reflog 找回
user@toolun-lab:~/project (main)$ git status -s
A app.js
A secret.env
✔ 通关：撤销最近一次提交，但保留改动。原理与背景
四个区域：命令其实只是在搬数据
几乎所有 Git 命令都可以理解为「把内容从一个区域搬到另一个区域」。工作区是你能看见、能编辑的文件；暂存区（index）是一份「下一次提交长什么样」的清单；本地仓库（.git）保存所有提交；远程仓库是另一台机器上的同一套东西。
理解了这张图，很多「怎么撤销」的问题就有了统一答案：改错了还没 add，用 git restore <file> 从暂存区拿回来；add 了不想提交，用 git restore --staged；提交了想撤，用 git reset；已经推送出去，只能用 git revert 追加一个反向提交。
提交是快照，分支只是指针
一个提交对象记录：整棵目录树的快照（不是差异）、父提交的 id、作者与时间、说明文字。这些内容经 SHA-1（新仓库可选 SHA-256）哈希得到提交 id，所以任何一处改动——哪怕只是改一个字的说明——都会得到一个全新的 id。这就是 --amend、rebase、cherry-pick 都「改写历史」的原因：它们生成的是新提交，旧提交只是不再被引用。
分支是 .git/refs/heads/<name> 里一个 40 位的文件，内容就是某个提交的 id。HEAD 通常指向某个分支名。因此建分支是瞬时的（写一个小文件），切分支是把 HEAD 改指向另一个名字并把工作区更新成那个提交的快照，删分支只是删掉一个指针——提交本身不会立刻消失。
merge 与 rebase 的取舍
merge 忠实记录发生过什么：两条线在合并提交处汇合，任何人都能看出这段功能是并行开发的。rebase 让历史看起来像一直是线性的，git log 更好读、git bisect 更好用，但代价是提交 id 全变。经验法则：自己的、还没推送的分支随便 rebase；别人可能基于它工作的分支只 merge。git pull --rebase 是这条规则的日常应用——把本地几个未推送的提交搬到远程最新之后，避免一堆「Merge branch 'main' of …」。
reset 的三种模式
--soft 适合「提交拆分 / 合并」：指针回去，内容仍在暂存区。--mixed（默认）适合「重新挑选要提交什么」。--hard 是真正的丢弃：工作区里没提交过的改动没有任何办法找回，而被撤掉的那些提交依旧躺在对象库里，git reflog 能看到 HEAD 每一次移动的记录，git reset --hard HEAD@{1} 就能回到 reset 之前。默认情况下 reflog 保留 90 天（不可达条目 30 天），这是 Git 给你的后悔窗口。
危险等级是怎么定的
「危险」标注给两类命令：会丢弃工作区未提交内容的（restore、reset --hard、clean、stash drop、checkout -- <file>），以及会改写别人可能已经拿到的历史的（push --force、branch -D 未合并分支）。「注意」给会改变状态但可挽回、或需要先确认影响范围的命令（commit --amend、rebase、merge --squash、push --delete）。只读命令（log、diff、status、show、blame）不标。
支持范围与限制
- 命令来源
- 以 Git 官方手册（git-scm.com/docs，Git 2.4x）为准；
git switch/git restore需要 2.23 及以上版本，旧写法checkout一并列出。 - 收录标准
- 日常开发、协作、排错会用到的命令与选项；每条都能在手册页找到对应说明。不收 plumbing 命令（
hash-object、cat-file、update-ref等）与平台特有操作（GitHub PR、GitLab MR 的网页操作）。 - 模拟终端
- 实现的是常用子命令的核心语义（快进 / 三方合并、按文件的冲突检测、
reset三模式、线性rebase、stash、远程推拉），不支持交互式 rebase、bisect、子模块、hooks、钩子与配置文件的全部选项；遇到冲突的 rebase 会自动放弃而不是停下等你解决。 - 不做什么
- 不连接真实仓库、不读取你电脑上的
.git、不提供图形化冲突解决器。 - 收藏与最近
- 只存本机浏览器，清除站点数据即消失。
典型使用场景
合并前把零碎提交整理干净
git rebase -i HEAD~N 配合 squash / fixup / reword；示意图里的 rebase 卡片能看到历史怎样从分叉变成直线，以及旧提交为什么变灰。
第一次协作：远程、跟踪、推送被拒
「远程协作」分组从 remote add 到 push -u、--force-with-lease，练习终端第 8 关（推送）和第 9 关（撤销已推送提交）覆盖了最常见的两次「推不上去」。
找回「消失」的东西
git reflog、git fsck --lost-found、git stash list 三条在「回退与撤销」里相邻；配方「找回误删的分支」两步完成。
常见问题
git reset 和 git revert 到底选哪个？
看提交有没有推送出去。没推送：reset 直接把指针拉回去，历史干净。已推送：revert 追加一个反向提交，不改写别人已经拿到的历史；否则下次别人 pull 就会遇到分叉。
为什么 git pull 之后出现「Merge branch 'main' of …」的提交？
因为本地有未推送的提交、远程也有新提交，默认 pull 用 merge 把两边合起来。想避免就用 git pull --rebase，或一次性设置 git config --global pull.rebase true。
--force 和 --force-with-lease 有什么区别？
--force 无条件覆盖远程分支。--force-with-lease 会先检查远程分支还是不是你上次 fetch 时看到的那个提交，别人推过新东西就拒绝——把「覆盖掉同事的提交」这种事故挡在门外。改写历史后的推送一律用后者。
模拟终端里的提交 id 为什么每次都一样？
真实 Git 的 id 由内容、作者、时间戳共同哈希得到；模拟器用逻辑时钟代替真实时间并用确定性哈希，同样的操作序列得到同样的 id，方便对照参考答案。它的 id 与真实 Git 算出的不一致，这是刻意的。
速查表里的命令在 Windows 上能用吗？
命令本身跨平台一致。差别在 shell：PowerShell 里 && 需要 7.x 版本，路径用引号包住更稳妥；换行符建议按「初始化与配置」里的 core.autocrlf 条目设置。
隐私
本页所有数据（命令表、示意图、模拟终端）都是随页面一起下载的静态内容，在你的浏览器里本地运行；搜索、复制、收藏、练习都不会向服务器发送任何请求。收藏记录保存在本机 localStorage，站点无法读取。页面上的外链指向 Git 官方文档，点击后由对方站点处理。
参考与延伸阅读
- Git Reference Manual（访问日期：2026-09-09）——每条命令的权威手册页，本页所有条目均据此核对。
- Pro Git 第二版（中文）（访问日期：2026-09-09）——第 3 章「分支」、第 7.7 节「重置揭密」是理解指针与三个区域的最佳入门。
- git-reset 手册页（访问日期：2026-09-09）——三种模式对 HEAD、index、working tree 影响的官方表格。
- git-rebase 手册页（访问日期：2026-09-09）——「Recovering from upstream rebase」一节解释了为什么共享分支不要 rebase。
参考资料
更新于 2026-09-09
Git 命令速查新
149 条 Git 命令按场景分组，每条含解释、示例与危险等级，可搜索、一键复制、收藏；附操作示意图与可练习的模拟终端
共 149 条
初始化与配置
14 条· 新仓库、克隆、身份与常用配置- 把当前目录变成 Git 仓库（生成 .git/）
git init git init -b main # 指定初始分支名
- 克隆远程仓库到本地，自动配置 origin
git clone https://github.com/git/git.git git clone git@github.com:user/repo.git my-dir
- 浅克隆：只取最新一次提交，省时间与空间
git clone --depth 1 --branch v2.0 https://github.com/user/repo.git
- 克隆并直接检出指定分支
git clone -b develop https://github.com/user/repo.git
- 设置提交者姓名（--global 对本机所有仓库生效）
git config --global user.name "Zhang San" git config --global user.email "zs@example.com"
- 只给当前仓库设置身份（公司 / 个人邮箱分开时用）
git config user.email "me@company.com"
- 列出全部配置及其来自哪个文件
git config --list --show-origin git config --get user.name
- 让以后 git init 的默认分支叫 main
- 换行符策略：Windows 常用 true，macOS/Linux 用 input
git config --global core.autocrlf input
- 设置提交信息编辑器（这里是 VS Code）
- 定义别名，把长命令缩短
git config --global alias.lg "log --oneline --graph --all" git lg
- 让 git pull 默认用变基而不是合并，避免多余的合并提交
- 记住 HTTPS 用户名密码 / token（明文存于 ~/.git-credentials）
Windows 通常已带 manager；macOS 用 osxkeychain 更安全。
- 打开该子命令的完整手册（等价 git <command> --help）
git help rebase git reset -h # 简短用法
日常提交
19 条· 看状态、暂存、提交、看差异- 查看工作区 / 暂存区状态：哪些改了、哪些已暂存、哪些未跟踪
git status git status -s # 短格式：M 修改 A 新增 D 删除 ?? 未跟踪
- 把文件的当前内容放进暂存区（下次提交的内容）
git add src/app.js git add src/ # 整个目录 git add "*.md" # 通配
- 暂存所有改动：新增、修改、删除（git add . 在 2.x 里等价）
git add -A git add -u # 只暂存已跟踪文件的修改与删除，不含新文件
- 交互式按「块」挑选要暂存的改动，一个文件里只提交一部分
git add -p src/app.js # y 暂存这块 n 跳过 s 拆得更小 q 退出
- 把暂存区内容做成一个提交
git commit -m "fix: 修正登录超时判断"
- 跳过 add：自动暂存已跟踪文件的修改后提交（新文件不会包含）注意
git commit -am "docs: update readme"
容易把不想提交的改动一起带进去，提交前先 git status。
- 用暂存区内容 + 新说明替换最近一次提交（改错字、补漏文件）注意
git add forgotten.js git commit --amend --no-edit # 补文件但不改说明 git commit --amend -m "新说明"
产生新的提交 id；已经推送过的提交不要 amend，否则需要强推。
- 创建一个没有改动的空提交（触发 CI、标记节点）
- 工作区 vs 暂存区：还没 add 的改动
git diff git diff src/app.js # 只看一个文件
- 暂存区 vs 最新提交：即将被提交的内容（--cached 同义）
git diff --staged
- 比较两个提交 / 分支之间的差异
git diff main feature git diff HEAD~3 HEAD -- src/ git diff main...feature # feature 相对分叉点的改动
- 只看每个文件改了多少行的统计
git diff --stat HEAD~1
- 按单词而不是按行显示差异，看文案改动更清楚
git diff --word-diff=color README.md
- 查看提交历史
git log git log -5 # 最近 5 条 git log --oneline # 一行一条
- 所有分支的历史画成图，带引用名
git log --oneline --graph --all --decorate
- 查看某个提交的信息与改动内容
git show HEAD git show a1b2c3d --stat git show HEAD:src/app.js # 看某版本的文件内容
- 删除文件并把「删除」放入暂存区
git rm old.txt git rm -r legacy/
- 只从版本库移除、保留本地文件（误提交了 node_modules / .env 时用）
git rm --cached .env echo ".env" >> .gitignore
- 重命名 / 移动文件并暂存（等于 mv + git add）
git mv utils.js helpers.js
分支
14 条· 创建、切换、重命名、删除- 列出本地分支（* 是当前分支）
git branch git branch -a # 含远程分支 git branch -vv # 带最新提交与跟踪关系
- 在当前提交创建分支，但不切换过去
git branch feature/login git branch hotfix a1b2c3d # 从指定提交创建
- 切换到已有分支（2.23+；旧写法 git checkout <branch>）
git switch main git switch - # 回到上一个分支
- 创建并切换到新分支（旧写法 git checkout -b）
git switch -c feature/search git switch -c hotfix origin/main # 基于远程分支
- 创建并切换（老写法，所有版本可用）
git checkout -b release/1.2
- 重命名分支（省略 old 则重命名当前分支）
git branch -m master main git push -u origin main && git push origin --delete master
- 删除已合并的本地分支（未合并会拒绝）
git branch -d feature/login
- 强制删除本地分支，不管是否合并危险
git branch -D experiment
分支上的独有提交会成为孤儿，短期内可用 reflog 找回。
- 列出已合并进当前分支的分支（清理时先看这个）
git branch --merged main git branch --no-merged # 反过来
- 把当前分支的上游设为某远程分支（之后 pull / push 不用写参数）
git branch -u origin/feature/login
- 哪些分支包含这个提交
git branch -a --contains a1b2c3d
- 检出某个提交进入「分离头指针」状态，只看不改时用注意
git checkout v1.0 git switch -c fix-from-v1 # 想保留改动就在此建分支
此状态下的提交不属于任何分支，切走后容易丢。
- 按最近提交时间排序列出分支，找最近在忙什么
git branch --sort=-committerdate | head
- 拉取时顺便删掉远程已不存在的分支引用（prune）
git fetch -p git remote prune origin
合并与变基
16 条· merge / rebase / cherry-pick，及冲突处理- 把 branch 合进当前分支：能快进就快进，否则生成合并提交
git switch main git merge feature/login
- 总是生成合并提交，保留「这里有过一个分支」的历史
git merge --no-ff feature/login
- 把分支所有改动压成一次暂存，由你手动做一个提交
git merge --squash feature/login git commit -m "feat: login"
- 合并冲突时放弃，回到合并前的状态
git merge --abort
- 解决冲突后：暂存已修好的文件，再提交完成合并
git add src/app.js git commit # 默认说明 Merge branch ...
- 冲突时整文件采用我方（当前分支）版本；--theirs 采用对方注意
git checkout --theirs package-lock.json git add package-lock.json
rebase 时 ours / theirs 含义反过来：ours 是被变基到的分支。
- 把当前分支的提交「搬」到 base 之后重放，得到直线历史注意
git switch feature git rebase main
所有被搬的提交 id 都会变；已推送并有人基于它工作的分支不要 rebase。
- 交互式变基：合并 / 改写 / 重排 / 删除从 commit 之后的提交注意
git rebase -i HEAD~3 # pick 保留 reword 改说明 squash 并入上一条 fixup 并入且丢说明 drop 删除
- 变基遇到冲突：解决并 add 后继续
git add . git rebase --continue
- 放弃这次变基，回到开始前
git rebase --abort
- 把 old-base..branch 这段提交移植到 new-base 之上
git rebase --onto main server client
适合「分支开错了地方」的情形。
- 先做 fixup 提交，变基时自动并入目标提交
git commit --fixup a1b2c3d git rebase -i --autosquash a1b2c3d~1
- 把某个提交的改动复制到当前分支（新 id）
git cherry-pick a1b2c3d git cherry-pick a1b2c3d..e5f6g7h # 一段范围（不含 a1b2c3d）
- 只应用改动到工作区与暂存区，不自动提交
git cherry-pick -n a1b2c3d
- 用配置的图形工具逐个解决冲突
git config --global merge.tool vscode git config --global mergetool.vscode.cmd "code --wait $MERGED" git mergetool
- 记住冲突解决方式，下次同样冲突自动复用
回退与撤销
16 条· 撤销工作区 / 暂存区 / 提交，找回丢失内容- 丢弃工作区改动，恢复成暂存区版本（旧写法 git checkout -- <file>）危险
git restore src/app.js git restore . # 整个目录
未暂存的改动会直接丢失，无法用 Git 找回。
- 取消暂存（把文件从暂存区拿出来，工作区改动保留）
git restore --staged src/app.js git reset HEAD src/app.js # 旧写法
- 把某个文件恢复到指定提交时的版本
git restore --source HEAD~2 config.yml git restore --source v1.0 -- src/
- 撤销最近一次提交，改动保留在暂存区（重新组织提交）
git reset --soft HEAD~1 git commit -m "更合适的说明"
- 撤销最近一次提交，改动回到工作区未暂存（默认 --mixed）
git reset HEAD~1
- 分支指针、暂存区、工作区全部回到 commit，未提交改动丢弃危险
git reset --hard HEAD~1 # 扔掉最后一次提交 git reset --hard origin/main # 与远程完全一致
工作区改动不可恢复；已提交的可用 git reflog 找回。
- 把某文件从暂存区移出（保留工作区），等价 restore --staged
git reset package-lock.json
- 生成一个新提交来抵消 commit 的改动，历史不变，可安全推送
git revert HEAD git revert a1b2c3d --no-edit
- 批量撤销一段提交，最后一起提交
git revert --no-commit HEAD~3..HEAD git commit -m "revert last 3 commits"
- 撤销一次合并（-m 1 表示保留第一个父提交那一侧）注意
git revert -m 1 f00ba12
撤销合并后再想合入同一分支需先 revert 这个 revert。
- HEAD 移动记录：reset / rebase / 删分支后找回「消失」的提交
git reflog git reset --hard HEAD@{2} # 回到 2 步之前的状态 git branch rescue a1b2c3d # 给孤儿提交建分支 - 删除所有未跟踪的文件和目录（先用 -n 预览）危险
git clean -n # 预览会删什么 git clean -fd # 执行 git clean -fdx # 连 .gitignore 里忽略的也删（如 node_modules）
- （旧写法）丢弃工作区改动，等价 git restore危险
git checkout -- src/app.js
- 列出不可达对象，reflog 也没有时的最后手段
git fsck --lost-found git show <dangling-commit-id>
- 找回误 drop 的 stash（stash 本质也是提交）
git fsck --unreachable | grep commit | cut -d" " -f3 | xargs git log --merges --no-walk
远程协作
18 条· remote / fetch / pull / push- 列出远程仓库及地址
git remote -v
- 添加远程仓库（本地 init 后关联 GitHub 时用）
git remote add origin git@github.com:user/repo.git
- 修改远程地址（HTTPS ↔ SSH、换仓库）
git remote set-url origin git@github.com:user/repo.git
- 重命名远程
git remote rename origin upstream
- 删除远程配置（不影响远程仓库本身）
git remote remove upstream
- 下载远程的新提交与分支到本地引用（origin/xxx），不改动工作区
git fetch git fetch origin main git fetch --all --prune
- fetch + merge：把上游分支合进当前分支
git pull git pull origin main
- fetch + rebase：把本地提交搬到远程最新之后，不产生合并提交
git pull --rebase origin main
- 把当前分支推到上游分支
git push git push origin main
- 首次推送新分支并建立跟踪关系（之后 git push 即可）
git push -u origin feature/login
- 删除远程分支（等价 git push origin :<branch>）注意
git push origin --delete feature/old git push origin --delete v0.1 # 也可删远程标签
- 改写历史后的「安全强推」：远程若被别人更新过会拒绝危险
git push --force-with-lease origin feature/login
优先用它而不是 --force。
- 无条件用本地覆盖远程分支危险
git push -f origin feature/login
会抹掉别人推上去的提交；共享分支禁止。
- 推送所有本地分支注意
git push --all origin
- 不克隆，直接列出远程的分支与标签
git ls-remote --heads origin git ls-remote --tags https://github.com/git/git.git
- fork 工作流：同步上游仓库的更新到本地
git remote add upstream https://github.com/original/repo.git git fetch upstream git switch main && git merge upstream/main
- 只允许快进拉取，有分叉就报错而不是悄悄合并
git pull --ff-only
贮藏 stash
9 条· 暂时收起未完成的改动- 把工作区与暂存区改动收起来，回到干净状态（等价 stash push）
git stash git stash push -m "登录页半成品"
- 连未跟踪的新文件一起 stash（默认不含）
git stash -u git stash -a # 连忽略文件也收
- 列出所有 stash（stash@{0} 最新）
git stash list
- 取出最新 stash 应用到工作区并删除它
git stash pop git stash pop stash@{2} - 应用 stash 但保留它（同一份改动要用到多个分支时）
git stash apply stash@{1} - 看某个 stash 改了什么
git stash show -p stash@{0} - 删除一个 stash危险
git stash drop stash@{0} git stash clear # 全部删除 - 从 stash 创建新分支并应用（stash 与当前分支冲突时最省事）
git stash branch fix-from-stash stash@{0} - 只 stash 指定文件
git stash push -m "只收起样式" -- src/styles/
标签
8 条· 给发布版本打标记- 列出标签
git tag git tag -l "v1.*" # 按模式过滤
- 附注标签：带作者、日期、说明，发布版本用这个
git tag -a v1.2.0 -m "Release 1.2.0"
- 轻量标签：只是一个指向提交的名字
git tag build-2026-09-09
- 给历史上的某个提交补打标签
git tag -a v1.1.1 a1b2c3d -m "补打"
- 查看标签信息与对应提交
git show v1.2.0
- 删除本地标签注意
git tag -d v1.2.0
- 删除远程标签注意
git push origin --delete v1.2.0
- 用最近的标签描述当前提交（v1.2.0-3-gabc1234：v1.2.0 之后 3 个提交）
git describe --tags --always
子模块与工作树
10 条· submodule / worktree / sparse-checkout- 把另一个仓库作为子模块引入
git submodule add https://github.com/user/lib.git vendor/lib
- 克隆后拉取所有子模块内容
git submodule update --init --recursive
- 克隆时顺带把子模块也拉下来
git clone --recurse-submodules https://github.com/user/repo.git
- 把子模块更新到其远程分支最新提交
git submodule update --remote vendor/lib git add vendor/lib && git commit -m "bump lib"
- 查看各子模块当前指向的提交
git submodule status
- 删除子模块（三步：deinit、rm、清 .git/modules）注意
git submodule deinit -f vendor/lib git rm -f vendor/lib rm -rf .git/modules/vendor/lib
- 在另一个目录同时检出另一个分支（不用 stash 来回切）
git worktree add ../repo-hotfix hotfix/1.2.1 git worktree add -b review ../repo-review origin/pr-42
- 列出所有工作树
git worktree list
- 删除一个工作树（目录与登记一起清掉）
git worktree remove ../repo-hotfix git worktree prune # 清理已手工删除目录的登记
- 只检出仓库的部分目录（大型单体仓库）
git clone --filter=blob:none --sparse <url> cd repo && git sparse-checkout set apps/web packages/ui
查历史与排错
18 条· 谁改的、什么时候坏的、搜历史- 某个文件的每次改动内容
git log -p -- src/app.js git log --follow -- src/app.js # 跨重命名跟踪
- 按提交说明搜索
git log --grep="登录" -i --oneline
- 找出增加或删除了某字符串的提交（pickaxe）
git log -S"validateToken" --oneline git log -G"regex" --oneline # 正则版
- b 有而 a 没有的提交
git log main..feature --oneline git log origin/main..HEAD # 还没推送的提交
- 自定义输出格式（%h 短 id %an 作者 %ar 相对时间 %s 说明）
git log --pretty=format:"%h %ad %an %s" --date=short -10
- 按时间范围筛选
git log --since="2026-09-01" --until="2026-09-09" --oneline
- 按作者统计提交数
git shortlog -sn --all --no-merges
- 逐行显示最后修改者与提交
git blame -L 40,60 src/app.js git blame -w -C src/app.js # 忽略空白、跟踪移动
- 二分查找引入 bug 的提交
git bisect start git bisect bad # 当前是坏的 git bisect good v1.1.0 # 这个版本是好的 # 反复测试并执行 git bisect good/bad git bisect reset
- 让脚本自动判定好坏，全自动二分
git bisect run npm test
- 在已跟踪文件中搜索（比 grep -r 快且不搜 node_modules）
git grep -n "TODO" -- "*.ts" git grep "foo" v1.0 # 在某个版本里搜
- 直接看某版本某文件内容，不切分支
git show HEAD~5:src/config.js > old-config.js
- 只列出改动过的文件名
git diff --name-only HEAD~3 HEAD git diff --name-status main # 带 M/A/D 状态
- 查看仓库对象数量与占用空间
git count-objects -vH
- 打包对象、清理垃圾，缩小 .git注意
git gc --aggressive --prune=now
prune 会真正删除不可达对象，reflog 里的后悔药会一起消失。
- 把引用解析成完整提交 id；--abbrev-ref 得到分支名
git rev-parse --short HEAD git rev-parse --abbrev-ref HEAD git rev-parse --show-toplevel # 仓库根目录
- 把某版本的文件导出成压缩包（不含 .git）
git archive -o release.zip v1.2.0 git archive HEAD src/ | tar -x -C /tmp/out
忽略与属性
7 条· .gitignore / .gitattributes / 大文件- 每行一个模式：node_modules/、*.log、!keep.log（取反）、/build（仅根目录）
# .gitignore node_modules/ dist/ *.log .env* !.env.example
- 解释某个文件为什么被忽略（哪条规则）
git check-ignore -v dist/app.js
- .gitignore 改了但已跟踪文件仍在：重新按规则加一遍注意
git rm -r --cached . git add . git commit -m "chore: apply .gitignore"
- 全局忽略文件（.DS_Store、Thumbs.db、编辑器目录）
echo ".DS_Store" >> ~/.gitignore_global git config --global core.excludesFile ~/.gitignore_global
- 本地改了配置文件但不想提交也不想被覆盖注意
git update-index --skip-worktree config/local.php git update-index --no-skip-worktree config/local.php # 取消
- 按路径设置换行、diff 方式、LFS 等属性
* text=auto *.sh text eol=lf *.png binary *.psd filter=lfs diff=lfs merge=lfs -text
- 用 Git LFS 管理大文件（先安装 git-lfs）
git lfs install git lfs track "*.psd" git add .gitattributes
常见组合
把几条命令串成「我要做一件事」的配方；展开后可整段复制。
撤销最近一次提交，但保留改动
提交早了 / 说明写错 / 想拆成两个提交（且尚未推送）
git reset --soft HEAD~1提交撤掉，改动仍在暂存区git status确认文件都在「要提交的变更」里git commit -m "新的说明"
撤销一个已经推送的提交
别人可能已经拉取了，不能改写历史
git revert <commit>生成反向提交git push
回退到某个版本（本地）危险
本地实验搞乱了，想彻底回到某个提交
git log --oneline找到目标提交 idgit stash -u（可选）先收起还想保留的改动git reset --hard <commit>
在 main 上提交了，想挪到新分支注意
忘了开分支就提交了 N 次
git branch feature/x在当前位置建分支（把这些提交「存」起来）git reset --hard origin/mainmain 回到远程状态git switch feature/x
把多个零碎提交合成一个注意
开 PR 之前整理历史（分支未被他人使用）
git rebase -i HEAD~4把后面几行的 pick 改成 squash 或 fixupgit push --force-with-lease分支已推送过才需要
让功能分支跟上 main 的最新进度
main 已经有新提交，功能分支要在其之上继续
git fetch origingit switch feature/xgit rebase origin/main或 git merge origin/main（保留合并提交）
把 master 改名为 main（含远程）注意
统一默认分支名
git branch -m master maingit push -u origin maingit push origin --delete master先在托管平台把默认分支切到 main
找回误删的分支
git branch -D 之后发现还有用
git reflog找到该分支最后一次提交的 id（如 "commit: xxx"）git branch <name> <commit-id>
误提交了密钥 / 大文件危险
.env 或几百 MB 的文件进了历史
git rm --cached .env && echo ".env" >> .gitignore若只在最近一次提交：接着 git commit --amendgit filter-repo --path .env --invert-paths已在历史深处：用 git-filter-repo 重写全部历史（需单独安装）git push --force-with-lease --all所有协作者都要重新克隆；泄露的密钥无论如何都要作废重发
把一个修复带到发布分支
main 上修好的 bug 也要进 release/1.2
git switch release/1.2git cherry-pick <commit>git push
合并冲突标准处理流程
git merge / pull 报 CONFLICT
git status看哪些文件「双方修改」code <file>在编辑器里处理 <<<<<<< ======= >>>>>>> 标记，保留正确内容git add <file>每修好一个就 add 一个git commitrebase 时则是 git rebase --continue
本地已有项目，推到新建的空远程仓库
先在本地写了代码，后来才在 GitHub 建了仓库
git init -b main && git add -A && git commit -m "init"git remote add origin git@github.com:user/repo.gitgit push -u origin main
操作示意图：每条命令让提交图发生了什么
圆点是提交、箭头指向父提交，绿色标签是分支、紫色是 HEAD 所在分支；灰色圆点表示不再被任何分支引用（可用 reflog 找回），实心是本次操作新产生的提交。
提交：在当前分支尾部追加一个节点
git add . && git commit -m "…"每个提交记住自己的父提交；分支只是指向某个提交的可移动指针，提交后 main 与 HEAD 一起前进。
建分支：只是多一个指针，不复制文件
git switch -c feature新分支和 main 指向同一个提交，所以建分支是瞬时的；之后在 feature 上提交，只有 feature 前进。
快进合并：main 没有独有提交时直接挪指针
git switch main && git merge feature不会产生新的提交，历史是一条直线。想保留「这里曾有一个分支」的痕迹就用 --no-ff。
三方合并：两边都有新提交时产生合并提交
git merge featureGit 找到共同祖先 b2，把两边相对 b2 的改动合到一起，生成有两个父提交的 m6。同一处改动不同才会冲突。
变基：把 feature 的提交「搬」到 main 之后重放
git switch feature && git rebase main历史变成一条直线，但 c3、d4 被新提交 c3′、d4′ 替代（id 变了）。已推送的分支不要 rebase，否则别人的历史会与你冲突。
reset：把分支指针拉回去（提交暂时变成孤儿）
git reset --hard HEAD~1--soft 只动指针；--mixed 再清暂存区；--hard 连工作区一起回退。孤儿提交 c3 在 reflog 里还能找回（默认保留 30 天以上）。
revert：用一个反向提交抵消，不改历史
git revert HEADc3 仍在历史里，新提交 r4 的内容等于把 c3 的改动反过来。已推送的提交要撤销就用它，不用 reset。
cherry-pick：只摘一个提交过来
git cherry-pick x7把 x7 相对其父提交的改动重放到 main 上，得到内容相同、id 不同的 x7′。适合把某个修复单独带到发布分支。
练习终端：在浏览器里敲一遍
一个纯内存的 Git 模拟器（不是真正的 Git，也不联网）：支持 init / add / commit / branch / switch / merge / rebase / reset / revert / stash / tag / remote / push / pull 等常用子命令，右侧提交图实时更新。10 关从「第一次提交」到「解决合并冲突」。Linux 命令的练习在Linux 命令速查。
git-lab — bash
Toolun Git 练习终端 —— 一个内存里的 Git，随便折腾，不会弄坏任何东西。
输入 git help 看支持的子命令；右侧选一关，按目标操作，每敲一条命令提交图都会更新。