macOS 上用 git rebase -i 交互式修改历史提交需注意编辑器配置、squash/fixup 压缩、reword 修改旧提交信息、edit 撤回文件误删等关键操作。

在 macos 上用 git 交互式变基修改历史提交，核心是 git rebase -i 命令配合终端编辑器操作。它不难，但几个关键点容易卡住——比如编辑器打不开、改完不会保存、squash 后不知道怎么处理提交信息。下面分场景说清楚。

确保编辑器能正常打开

执行 git rebase -i HEAD~3 卡在空白界面或直接退出？大概率是 Git 没配好默认编辑器。

• 先检查当前配置：git config --global core.editor，如果没输出或显示 code --wait 但 VS Code 没装，就得换一个
• macOS 推荐临时指定 nano（系统自带，不用额外安装）：
  GIT_EDITOR="nano" git rebase -i HEAD~3
• 如果习惯 VS Code，确认已运行过 code --install-server，再用：
  GIT_EDITOR="code --wait" git rebase -i HEAD~3

压缩多次提交为一个（保留最新那条描述）

比如刚连着 commit 了三次，内容相关但信息重复，想压成一条且只留最后一次的提交文字。

batch-git-url-replace

批量替换指定目录下所有 Git 仓库的远程地址（remote URL）。 当用户需要将 Git 仓库从一个服务器迁移到另一个服务器时使用。 触发词：git remote 替换、git url 批量修改、git 仓库迁移、更换 git 地址、批量修改 remote url。

下载

• 运行 GIT_EDITOR="nano" git rebase -i HEAD~3
• 编辑器里会列出三行，从旧到新排列（第一行是最老的提交）
• 把**前两行**开头的 pick 改成 fixup（小写），第三行保持 pick
• 保存退出：nano 中按 Ctrl+O → 回车 → Ctrl+X
• Git 自动合并代码变更，跳过编辑提交信息环节——因为 fixup 会丢弃前两条的信息

修改某次历史提交的信息（非最新）

要改的不是最近一次，比如想修正三天前某次 commit 的标题错别字。

• 先用 git log --oneline -n 10 找到目标提交和它的前一个提交哈希（比如目标是 abc1234，前一个是 def5678）
• 运行：GIT_EDITOR="nano" git rebase -i def5678
• 在编辑器中找到 abc1234 那一行，把 pick 改成 reword（或简写 r）
• 保存退出后，Git 会停在该提交，并自动打开编辑器让你重写 message
• 改完保存退出（nano 同上），再执行 git rebase --continue 完成

撤回某个文件的历史修改

发现某次提交里误删了一个配置文件，想把它“还原”回来，但又不想整个提交都撤销。

• 先用 git rebase -i 把那个提交标记为 edit（e）
• Git 暂停后，用 git log --oneline -- path/to/file 查这个文件的历史
• 找到它还存在的那个提交哈希，比如 9a8b7c6，执行：
  git restore --source=9a8b7c6 --staged --worktree path/to/file
• 然后 git add path/to/file → git commit --amend → git rebase --continue