git restore --staged 是 git 2.23+ 官方推荐的最安全取消暂存方式，仅修改暂存区、不触碰工作目录，语义清晰无歧义，支持单文件、多目录及批量操作，并可交互式部分撤销。
git restore --staged 是当前最安全的取消暂存方式
Git 2.23+ 版本起，git restore --staged 是官方明确推荐、语义最清晰的取消暂存命令。它只动暂存区（index），完全不动工作目录里的修改——哪怕你刚改完 .env 里一堆密钥，执行后文件内容原封不动，只是从“待提交”变回“已修改未暂存”。
-
git restore --staged README.md：取消单个文件 -
git restore --staged src/ utils/：取消多个目录下所有暂存文件 -
git restore --staged '.'：取消当前目录及子目录下所有暂存文件（注意引号或点号前加空格防 shell 展开）
它比老命令更直观：restore = 恢复暂存区状态；--staged = 仅作用于暂存区。没有歧义，不依赖 HEAD，也不触发重置逻辑。
git reset -- 和 git rm --cached 的适用边界
git reset -- <file></file> 仍广泛可用，但容易误写成 git reset（缺路径）或 git reset --hard（灾难性）。它本质是“把 HEAD 的索引快照覆盖回暂存区”，所以要求该文件在上一次提交中存在；若文件是全新添加且从未提交过，git reset -- <file></file> 会报错 “pathspec 'xxx' did not match any files”。
-
git rm --cached <file></file>真正用途是“停止跟踪但保留本地文件”，比如你想把.env从版本库移除又不想删掉它——它不是为“取消暂存”设计的，只是副作用刚好能清暂存。慎用于批量操作，因为一旦漏掉--cached，就会真删文件。 - 二者都不支持交互式部分撤销（比如只撤回某几行暂存），这点
git restore --staged --patch可以做到。
VS Code 里点错“暂存”怎么办？别慌，右键就有救
在 VS Code 源代码管理面板，“暂存的更改”区域里右键文件 → “撤销暂存更改”，等效于执行 git restore --staged <file></file>。快捷键是选中已暂存文件后按 Alt+Backspace（Windows/Linux）或 Option+Delete（macOS）。
- 想一次性撤回全部？点击“暂存的更改”标题旁的
⋯菜单 → “撤销所有暂存的更改” - 注意：如果文件已被修改且暂存过，再撤销暂存后，它会回到“更改”列表，但内容不会变——和命令行行为完全一致
- 别用编辑器顶部的“放弃更改”横幅，那是丢弃工作区修改，不是取消暂存
误用 git checkout -- 或 git reset --hard 会直接丢数据
这两个命令常被当成“取消暂存”的捷径，但它们根本不是干这个的：git checkout -- <file></file> 是用暂存区内容覆盖工作区，等于手动删掉你刚写的代码；git reset --hard 更狠，直接把暂存区 + 工作区一起打回上一个 commit，所有未提交改动灰飞烟灭。
- 只要看到命令里带
--hard、checkout --、或者没带--staged/--cached却在处理暂存问题，立刻停手 - 真正危险的是：这些命令不二次确认，执行完就没了，Git 不留历史痕迹
- 如果你已经执行了
git checkout -- .env并丢失了敏感配置，唯一补救是看编辑器是否还缓存着未保存内容，或系统回收站里有没有临时备份
暂存区是 Git 三层结构（工作目录 → 暂存区 → 仓库）中最易被忽略的一层，但它恰恰是防止误操作的关键缓冲带——所有安全操作都该以“只动暂存区”为底线。
