docs(blogs): add git usage cheatsheet

- Cover git update-index --skip-worktree for ignoring local changes to tracked files - Include stashing, amending, undo, reflog, bisect, log, clean and cherry-pick tips - Add matching zh-hans and en-gb versions
2026-08-20 15:09:25 +08:00
1 parent 25a50486cb
commit 7f6f3d7a00
@@ -0,0 +1,161 @@
+---
+title: Git 使用小贴士
+tags:
+  - git
+  - tips
+author:
+  name: Zihlu Wang
+  email: real@zihluwang.me
+---
+
+## 忽略已跟踪文件的本地改动：`git update-index --skip-worktree`
+
+当你需要在本机修改某个已被 Git 跟踪的文件，但又不希望这些改动出现在 `git status` 或提交里时（比如本地的 `application-local.yml`、`.env`、IDE 配置等），可以使用 `--skip-worktree` 让 Git 忽略该文件的本地改动。
+
+### 标记与取消标记
+
+```bash
+# 让 Git 忽略该文件的本地改动
+git update-index --skip-worktree <file>
+
+# 取消忽略，恢复对该文件的跟踪
+git update-index --no-skip-worktree <file>
+```
+
+### 查看所有被忽略的文件
+
+被标记的文件会在 `git ls-files -v` 的输出中以 `S` 标识：
+
+```bash
+git ls-files -v | grep '^S'
+```
+
+### 提交对已标记文件的改动
+
+如果需要向仓库提交该文件的新改动，需要先取消标记、提交、再重新标记：
+
+```bash
+git update-index --no-skip-worktree <file>
+git add <file>
+git commit -m "chore: update config"
+git update-index --skip-worktree <file>
+```
+
+### `--skip-worktree` 与 `--assume-unchanged` 的区别
+
+两个选项都能让 Git 不再关注已跟踪文件的改动，但用途不同：
+
+| 选项                 | 用途                                                                         |
+| -------------------- | ---------------------------------------------------------------------------- |
+| `--assume-unchanged` | 性能优化，适用于几乎不会改变的大型文件；Git 检测到文件变化后可能自动重新跟踪 |
+| `--skip-worktree`    | 有意忽略本地改动，适用于「保持本地修改但不上传」的场景，更持久               |
+
+因此，「忽略本地改动」应该使用 `--skip-worktree`。
+
+### 注意事项
+
+- `--skip-worktree` 只影响工作区层面，并不是一个「永久忽略」。在执行 `git pull`、`git checkout`、`git stash` 等可能改写该文件的操作时，本地改动可能会被覆盖或引发冲突。如果该文件在远端也会变化，建议在拉取前先取消标记。
+- 它只对**已跟踪**的文件生效；对于未跟踪的文件，请使用 `.gitignore`。
+
+## 暂存未完成的改动：`git stash`
+
+需要临时切换分支时，可以用 `git stash` 把工作区改动保存起来：
+
+```bash
+git stash push -m "work in progress"  # 保存并附带备注
+git stash -u                          # 连同未跟踪的文件一起保存
+git stash list                        # 查看已保存的改动
+git stash pop                         # 恢复并删除该条记录
+git stash apply                       # 恢复但保留该条记录
+git stash drop                        # 删除某条记录
+```
+
+## 修正最近一次提交：`git commit --amend`
+
+当你提交后发现忘了加入某些文件、或想修改提交信息时：
+
+```bash
+git add <forgotten-file>
+git commit --amend                  # 保持原提交信息，合并进新改动
+git commit --amend -m "新提交信息"    # 同时修改提交信息
+```
+
+注意：如果该提交已经被推送到远端，请改用新增一个提交的方式，避免改写公共历史。
+
+## 撤销改动：`git restore` 与 `git reset`
+
+```bash
+git restore <file>               # 丢弃工作区（未暂存）的改动
+git restore --staged <file>      # 取消暂存，保留改动（相当于 git reset HEAD <file>）
+git restore --source=HEAD <file> # 将文件恢复到 HEAD 版本
+```
+
+想彻底丢弃未提交的全部改动（包括暂存区），可以：
+
+```bash
+git reset --hard HEAD
+```
+
+`--hard` 会连同工作区一并重置，使用前请确认没有需要保留的改动。
+
+## 找回丢失的提交：`git reflog`
+
+误用了 `git reset --hard` 或 `git rebase` 导致提交「消失」时，`reflog` 记录了 HEAD 的所有历史位置：
+
+```bash
+git reflog
+git reset --hard HEAD@{2}   # 回到 reflog 中记录的某个位置
+```
+
+只要提交还在对象库中，就能通过 reflog 找回。
+
+## 二分查找回归：`git bisect`
+
+当某个 bug 不知道从哪个提交引入时，`git bisect` 会通过二分法帮你定位：
+
+```bash
+git bisect start
+git bisect bad        # 当前提交是有问题的
+git bisect good <sha> # 标记一个已知正常的提交
+```
+
+Git 会不断切换到一个中间提交，你只需要根据当前状态标记 `good` 或 `bad`，最终会定位到引入 bug 的那个提交：
+
+```bash
+git bisect good   # 或 git bisect bad
+git bisect reset  # 结束并回到原分支
+```
+
+## 更友好的历史记录：`git log`
+
+```bash
+git log --oneline --graph --decorate --all   # 以图形方式查看全部分支
+git log -S "some-string" --all               # 查找新增或删除某字符串的提交
+git blame <file>                             # 查看每行代码的最后修改者
+git blame -L 10,20 <file>                    # 只查看指定行范围
+```
+
+## 清理未跟踪文件：`git clean`
+
+```bash
+git clean -n -fd   # 先预览会被删除的文件（安全起见务必先跑）
+git clean -fd      # 删除未跟踪的文件和目录
+```
+
+`-n` 表示只展示而不实际删除，建议先预览再执行。
+
+## 精挑细选：`git cherry-pick`
+
+把其他分支上的某个提交应用到当前分支：
+
+```bash
+git cherry-pick <sha>
+```
+
+## 清理已合并的本地分支
+
+```bash
+git branch --merged | grep -v '\*' | xargs -n 1 git branch -d
+```
+
+该命令会删除所有已合并进当前分支的本地分支（当前分支除外）。执行前建议先用 `git branch --merged` 预览。