git reset HEAD 和 git restore --staged 均仅取消暂存，不改变工作区代码；前者易因漏参数误重置全部暂存区，后者语义更清晰且安全。
直接执行 git reset HEAD 或 git restore --staged 就能从暂存区移出文件，但这两者都**不会还原你本地改过的代码内容**——很多人卡在这一步，以为文件“恢复了”，结果发现编辑历史还在、冲突也没消。
用 git reset HEAD 撤回单个文件的暂存
这是最常用也最易误解的操作。它只让 Git 忘记“这个版本被 git add 过”，工作区文件内容完全不变：
- 如果
add前你刚保存过一次，add后没再改，那撤回后状态和add前一致 - 如果
add后又改了几行，撤回后那些新改的行依然在，Git 不会帮你回退到add前的快照 - 命令里必须写明具体文件路径，
git reset HEAD不带参数会重置整个暂存区（即--mixed），容易误操作
用 git restore --staged 更语义清晰（Git 2.23+）
功能和 git reset HEAD 完全一致，但优势在于：它不碰 HEAD 指针，也不会因少打一个参数就变成全量重置。适合习惯明确动词表达的人：
- 旧版 Git（unknown subcommand 'restore'
- 它和
git reset一样，对工作区零影响；想同时丢弃工作区修改，得加--worktree（慎用） - 终端里输
git restore -h可看到所有可用标志，比如-S是 shorthand for--staged
真正想找回 add 前的代码？用 PhpStorm 的 Local History
Git 层面的命令救不了内容，这时候就得靠 IDE 自带的快照机制。PhpStorm 的 Local History 是独立于 Git 的自动记录，只要文件被 IDE 跟踪且你至少保存过一次，它就存着 add 前那一刻的内容：
- 右键误
add的文件 →Local History→Show History - 在时间线里找带
Saved或Edited标签、且在git add时间点之前的那条 - 选中 → 点右下角
Revert（不是复制粘贴！），当前文件会覆盖成那个快照 - 如果只差几行，双击历史版本打开对比视图，右键某段 →
Copy Lines from Left to Right更安全
为什么右键 Local History 是灰色的？
不是功能坏了，而是文件没被 PhpStorm 正确纳入监控：
- 路径在
Settings → Editor → File Types → Ignore files and folders里（比如误加了src/**） - 文件放在被排除目录下，如
node_modules/、vendor/、build/ - 文件刚新建还没按过
Ctrl+S—— Local History 不记录“未保存”的初始状态 - 右键 →
Mark as Plain Text了，IDE 就不再为其生成快照 - 快捷键
Alt+Shift+C（Win/Linux）或Cmd+Shift+A搜Show Local History，有时能绕过右键失效
关键点始终是：Git 的暂存操作本身不保存快照，它只标记“准备提交哪些变更”。真要回退内容，得靠 IDE 的 Local History 或你自己提前做的 git commit。别等 add 后才发现改乱了才想起来查文档。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
