Git取消暂存：保留本地修改与丢弃修改不是一回事

想把文件移出下一次提交，不需要丢掉已经写好的内容。本文解释restore的作用范围，提醒操作前先确认来源与目标区域。

先说清楚你要撤销什么

Git取消暂存与丢弃本地修改是不同操作。如果只是暂时不想把某个文件放进下一次提交，目标是索引；如果希望文件内容回到某个版本，目标才是工作区。两个动作都可能用到restore，但参数不同，影响也不同。

先用git status和差异查看确认当前内容，并备份重要的未提交工作。普通已有提交的仓库中，git restore --staged -- 文件路径可用于取消该文件暂存，本地修改通常仍留在工作区。执行后再次看状态与文件内容，不要只根据命令没有报错判断结果。

丢弃内容前核对恢复来源

不带--staged的restore会作用于工作区，其来源与参数有关，可能覆盖尚未提交的编辑。不要在不理解的情况下对整个目录执行恢复，也不要把恢复命令写进自动清理脚本。路径和选项之间使用明确分隔，有助于减少特殊文件名带来的歧义。

建议先在测试仓库用一个文件演示：修改、暂存、取消暂存，再比较三次状态。确认理解后再处理真实源码。验收标准是需要保留的文字仍然存在，下一次提交只包含计划中的内容。如果目的是撤销已经发布的提交，应评估revert等方案，而不是用工作区恢复命令期待改变远程历史。

官方参考

资料核对日期：2026年10月26日。

Git：git-restore