Git不支持撤销单个文件的提交，因commit是原子操作；正确做法是用git reset HEAD~1 -- file.txt将该文件从暂存区移除，再执行git commit --amend --no-edit重写上次提交，使其不包含该文件变更。
撤销单个文件的提交，但保留其他已暂存文件
Git 本身不支持“只撤销某个文件的提交”，因为 commit 是原子操作——它记录的是整个暂存区（index）快照。但你真正想做的，通常是：**这个文件误提交了，现在想把它从上一次提交里剔除，同时不碰其他文件的变更**。这本质是“修改最近一次提交”，而不是“删除某个文件的提交记录”。
常见错误现象：git reset HEAD~1 file.txt 看似合理，但实际无效——reset 不接受路径参数来撤回已提交的内容；或者误用 git checkout HEAD~1 -- file.txt，结果把工作区改回旧版本，却没动提交本身。
- 正确做法是先用
git reset HEAD~1 -- file.txt把该文件从上一次提交中“反选出来”（即从暂存区移除，但保留工作区修改） - 再执行
git commit --amend --no-edit，重写最后一次提交，此时file.txt的变更就不再属于该提交 - 注意：如果该文件在
HEAD~1中原本就存在且未被修改，这条命令不会报错但也不起作用；只有当它在上次提交中是“新增”或“被修改后提交”的，才真正被剥离
文件已推送到远程，还能撤销吗
能，但代价是改写历史——必须强制推送（git push --force-with-lease），且所有协作者需同步更新本地分支。这不是“撤销”，而是“用一个新提交替代旧提交”。
使用场景：你刚 push 完，发现 config.local.json 被误提交，还没人基于它做后续开发。
- 先本地修正：按上一节方法
git reset HEAD~1 -- config.local.json+git commit --amend --no-edit - 再强制推送：
git push --force-with-lease origin main（别用--force，它可能覆盖他人新提交） - 如果远程拒绝（比如别人已推送新提交），说明历史已分叉，此时不能简单强推，得先
git pull --rebase合并，再重新--amend和--force-with-lease
只想丢弃该文件的修改，不关心提交历史
如果你根本不想保留这个文件的任何改动（比如误加了大日志文件、临时调试代码），目标是“让工作区和暂存区都干净地回到没改过它的状态”，那就别碰 commit，直接清理即可。
仅从仓库的暂存文件生成 Git 提交消息。当用户要求 Codex 根据暂存更改、缓存差异、Git 索引或已通过 `git add` 添加的文件来编写、起草、创建或建议提交消息时使用；切勿代表用户执行提交操作。
- 若文件尚未提交（只在工作区或暂存区）：
git checkout -- file.log（丢弃工作区修改）或git reset HEAD -- file.log（仅从暂存区撤下） - 若已提交且只想删掉它（连同历史）：
git rm --cached file.log（保留在磁盘但不再跟踪），再git commit -m "remove file.log from tracking" - 如果文件含敏感内容（如密码），仅
rm --cached不够——必须用git filter-repo彻底从历史中擦除，否则.git对象里还留着
为什么不用 git revert file.txt
git revert 没有路径参数，它只能针对整个提交（commit）生成逆向补丁。你写 git revert HEAD -- file.txt 会报错：error: unknown option `file.txt'。
有人试图用 git show HEAD:file.txt > /dev/null 验证文件是否存在，但这只是检查“上次提交里有没有这个路径”，和能否单独回退它无关。
真正能接近“单文件回退”的，是 git restore -s HEAD~1 -- file.txt（Git 2.23+），但它只改工作区/暂存区，不改提交本身——也就是说，它帮你把文件内容恢复到前一个版本，但原提交依然包含旧版本。这不是撤销提交，只是还原内容。
复杂点在于：Git 的设计哲学是“提交不可变”，所有“撤销”本质上都是新增提交或重写历史。容易被忽略的是——只要提交被推送过、被人拉取过，--amend 和 --force-with-lease 就不再是私人事，得协调协作方。
