从最新提交中移除文件

技术背景

在使用Git进行版本控制时，有时会不小心将一些文件错误地提交到了最新的提交中。这时，我们需要将这些文件从最新提交中移除，但又不想丢失对这些文件所做的更改，或者不想删除这些文件。

实现步骤

移除最新提交中的文件并保留更改

1. 将最新提交回退到暂存区：

   git reset --soft HEAD^ 

   或者

   git reset --soft HEAD~1

2. 重置不需要的文件，使其不包含在提交中：
   • 旧方法（Git 2.23.0 之前）：

   git reset HEAD path/to/unwanted_file

   • 新方法（Git 2.23.0 及之后）：

   git restore --staged path/to/unwanted_file

3. 再次提交，可重用相同的提交消息：

   git commit -c ORIG_HEAD

完全删除文件（本地和远程仓库）

1. 删除文件：

   git rm <file>

2. 使用 –amend 标志提交：

   git commit --amend

从旧提交中移除文件

1. 查找要使文件符合的提交：

   git log --graph --decorate --oneline

2. 检出该提交：

   git checkout <commit_id> <path_to_file>

   若要移除多个文件，可多次执行此命令。
3. 提交更改：

   git commit -am "remove unwanted files"

4. 找到错误添加文件的提交 ID，例如“35c23c2”，然后进行交互式变基：

   git rebase 35c23c2~1 -i

5. 在编辑器中，将最后一个提交（“remove unwanted files”）移动到错误提交（“35c23c2”）的下一行，并将命令设置为 fixup：

   pick 35c23c2 the first commit
   fixup 0d78b28 remove unwanted files

   保存文件。
6. 强制推送：

   git push -f

使用图形界面工具

使用 git gui 或 gitkraken 等图形界面工具，选择 Commit => Amend Last Commit，取消选中要移除的文件，然后点击 Commit。

核心代码

从最新提交中移除文件并保留更改

git reset --soft HEAD~1
git restore --staged path/to/unwanted_file
git commit -c ORIG_HEAD

完全删除文件（本地和远程仓库）

git rm <file>
git commit --amend

从旧提交中移除文件

git log --graph --decorate --oneline
git checkout <commit_id> <path_to_file>
git commit -am "remove unwanted files"
git rebase <commit_id>~1 -i
# 在编辑器中修改为 fixup
git push -f

最佳实践

• 优先使用 git restore --staged 命令，因为它是 Git 2.23.0 及之后版本的推荐命令。
• 在进行交互式变基（git rebase -i）时，仔细检查每个提交，避免意外修改历史记录。
• 使用图形界面工具可以简化操作，特别是对于不熟悉命令行的用户。

常见问题

冲突问题

在进行变基或强制推送时，可能会遇到冲突。这时需要手动解决冲突，然后继续进行操作。

备份问题

使用 git filter-branch 命令时，可能会出现备份问题。如果提示“Cannot create a new backup. A previous backup already exists in refs/original/ Force overwriting the backup with -f”，可以删除本地仓库中的备份：

rm -rf .git/refs/original/refs