git reset HEAD 仅取消暂存，不还原文件内容；若add后又修改，工作区仍为最新态，无法回退到add前版本。
git reset HEAD 不能恢复未提交的暂存文件？
直接执行 git reset HEAD <file></file> 只能取消已 git add 但尚未 git commit 的暂存状态，但它**不会还原文件内容本身**——如果 add 前你刚改过代码，add 后又继续改了，git reset 只是让 Git 忘掉“这个版本被暂存过”，当前工作区内容仍是最新编辑态。很多人误以为它能回退到 add 前的样子，结果发现代码还是乱的。
想撤回 add 且保留原始修改？用 Local History 最稳
PhpStorm 的 Local History 是独立于 Git 的自动快照，只要文件被 IDE 跟踪、且你至少保存过一次，它就记得 git add 前那一刻的内容。这比依赖 Git 状态更可靠，尤其当你手滑 git add . 又没 commit 就继续改了时。
- 右键点击被误 add 的文件 →
Local History→Show History - 在时间线里找
git add操作前最近的一条记录（通常带 “Saved” 或 “Edited” 标签） - 选中那条 → 点右下角
Revert（不是复制粘贴！） - 确认弹窗后，文件会瞬间回到 add 前的状态，且所有行变更高亮可见
注意：Revert 是覆盖操作，当前未保存的修改会丢失；如果只差几行，双击历史版本打开对比视图，右键某段选 Copy Lines from Left to Right 更精准。
为什么右键 Local History 灰掉或点不动？
常见原因不是功能坏了，而是文件没被 PhpStorm 正确纳入监控：
立即学习“PHP免费学习笔记（深入）”；
- 文件路径在
Settings → Editor → File Types → Ignore files and folders列表里（比如误加了src/**） - 文件放在被排除的目录下（如
node_modules/、vendor/、build/） - 文件刚新建还没执行过
Ctrl+S—— Local History 不记录“未保存”的初始状态 - 文件类型被设为
Plain Text（右键 →Mark as Plain Text），IDE 就不再为其生成快照
快捷键 Alt+Shift+C（Win/Linux）或 Cmd+Shift+A 搜 Show Local History 有时能绕过右键失效问题。
git restore --staged 和 git reset 的区别在哪？
Git 2.23+ 推出的 git restore --staged <file></file> 语义更清晰，和 git reset HEAD <file></file> 功能一致，都是把文件从暂存区移出、不碰工作区。但关键差异在于：
-
git restore --staged不会影响HEAD指针，而git reset在无参数时默认是--mixed，容易误敲成git reset全部重置 - 如果你用的是旧版 Git（git restore 命令不存在，必须用
git reset HEAD - 两者都**无法找回 add 前的代码内容**——那是 Local History 或
git checkout -- <file></file>的事，但后者会丢弃你后续所有未暂存修改
真正容易被忽略的是：Local History 默认只保留 5 天快照，大项目里频繁编辑可能让关键节点被自动清理；如果处理核心逻辑，建议手动触发一次保存（Ctrl+S）再做高危操作，确保快照锚点存在。
