• 简体中文

      • Git 使用小贴士

      忽略已跟踪文件的本地改动：git update-index --skip-worktree

      当你需要在本机修改某个已被 Git 跟踪的文件，但又不希望这些改动出现在 git status 或提交里时（比如本地的 application-local.yml、.env、IDE 配置等），可以使用 --skip-worktree 让 Git 忽略该文件的本地改动。

      标记与取消标记

      # 让 Git 忽略该文件的本地改动
git update-index --skip-worktree <file>

# 取消忽略，恢复对该文件的跟踪
git update-index --no-skip-worktree <file>

      查看所有被忽略的文件

      被标记的文件会在 git ls-files -v 的输出中以 S 标识：

      git ls-files -v | grep '^S'

      提交对已标记文件的改动

      如果需要向仓库提交该文件的新改动，需要先取消标记、提交、再重新标记：

      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 把工作区改动保存起来：

      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

      当你提交后发现忘了加入某些文件、或想修改提交信息时：

      git add <forgotten-file>
git commit --amend                  # 保持原提交信息，合并进新改动
git commit --amend -m "新提交信息"    # 同时修改提交信息

      注意：如果该提交已经被推送到远端，请改用新增一个提交的方式，避免改写公共历史。

      撤销改动：git restore 与 git reset

      git restore <file>               # 丢弃工作区（未暂存）的改动
git restore --staged <file>      # 取消暂存，保留改动（相当于 git reset HEAD <file>）
git restore --source=HEAD <file> # 将文件恢复到 HEAD 版本

      想彻底丢弃未提交的全部改动（包括暂存区），可以：

      git reset --hard HEAD

      --hard 会连同工作区一并重置，使用前请确认没有需要保留的改动。

      找回丢失的提交：git reflog

      误用了 git reset --hard 或 git rebase 导致提交「消失」时，reflog 记录了 HEAD 的所有历史位置：

      git reflog
git reset --hard HEAD@{2}   # 回到 reflog 中记录的某个位置

      只要提交还在对象库中，就能通过 reflog 找回。

      二分查找回归：git bisect

      当某个 bug 不知道从哪个提交引入时，git bisect 会通过二分法帮你定位：

      git bisect start
git bisect bad        # 当前提交是有问题的
git bisect good <sha> # 标记一个已知正常的提交

      Git 会不断切换到一个中间提交，你只需要根据当前状态标记 good 或 bad，最终会定位到引入 bug 的那个提交：

      git bisect good   # 或 git bisect bad
git bisect reset  # 结束并回到原分支

      更友好的历史记录：git log

      git log --oneline --graph --decorate --all   # 以图形方式查看全部分支
git log -S "some-string" --all               # 查找新增或删除某字符串的提交
git blame <file>                             # 查看每行代码的最后修改者
git blame -L 10,20 <file>                    # 只查看指定行范围

      清理未跟踪文件：git clean

      git clean -n -fd   # 先预览会被删除的文件（安全起见务必先跑）
git clean -fd      # 删除未跟踪的文件和目录

      -n 表示只展示而不实际删除，建议先预览再执行。

      精挑细选：git cherry-pick

      把其他分支上的某个提交应用到当前分支：

      git cherry-pick <sha>

      清理已合并的本地分支

      git branch --merged | grep -v '\*' | xargs -n 1 git branch -d

      该命令会删除所有已合并进当前分支的本地分支（当前分支除外）。执行前建议先用 git branch --merged 预览。

      gittips