最安全、最推荐的方式是 git restore --staged，它只修改暂存区、不触碰工作区，语义清晰，支持交互式部分撤销（--patch），且对全新未提交文件也安全有效。
最安全、最推荐的方式是 git restore --staged，Git 2.23+ 官方明确指定它为取消暂存的首选命令，语义清晰、不碰工作区、支持交互式部分撤销。
为什么不用 git reset --？
它看似常用，但有三个实际痛点：
- 要求文件在上一次提交中存在；如果刚
git add了一个全新文件（比如.env），执行git reset -- README.md会报错：pathspec 'README.md' did not match any files - 容易误写成
git reset（缺参数）或git reset --hard（灾难性），尤其在终端快速操作时 - 不支持只撤回某几行修改（
--patch），而git restore --staged --patch可以
git restore --staged 怎么用？
记住核心原则：它只改暂存区，工作目录内容完全不动。常见用法：
- 取消单个文件：
git restore --staged README.md - 取消整个目录下所有暂存：
git restore --staged src/（结尾不加斜杠也行，但加更明确） - 取消当前目录及子目录所有暂存：
git restore --staged '.'（注意引号，防 shell 展开） - 交互式部分撤销（比如只撤回某几行暂存）：
git restore --staged --patch src/index.js
VS Code 里点错“暂存”怎么办？
根本不用切终端：
- 在源代码管理面板 → “暂存的更改”区域右键文件 → 点“撤销暂存更改”，等效于
git restore --staged <file></file> - 快捷键：选中已暂存文件后按
Alt+Backspace（Windows/Linux）或Option+Delete（macOS） - 想一次性撤回全部？点“暂存的更改”标题旁的 ⋯ 菜单 → “撤销所有暂存的更改”
- ⚠️ 别点编辑器顶部弹出的“放弃更改”横幅——那是丢弃工作区修改，不是取消暂存
老项目或旧 Git 版本怎么办？
若 Git 版本低于 2.23（比如 CentOS 7 自带的 Git 1.8），只能退而求其次用 git reset HEAD <file></file>，但必须注意：
- 它本质是“用 HEAD 对应的索引快照覆盖暂存区”，所以对全新未提交文件无效
- 批量取消暂存时，别漏写
HEAD：正确是git reset HEAD src/，错误是git reset src/（这会重置分支） - 如果已经误用了
git checkout -- <file></file>或git reset --hard，它们会覆盖工作区，导致刚写的代码直接丢失——这种误操作无法靠命令自动挽回，只能从git reflog或编辑器本地历史里抢救
真正容易被忽略的是：取消暂存 ≠ 放弃修改。无论用哪个命令，只要没动工作区，你改的代码都还在磁盘上，只是从“待提交”变回“已修改未暂存”。关键在于分清「暂存区」和「工作区」这两层状态，否则一慌就容易把 --staged 写成 --hard。
