PhpStorm不能一键删除未使用变量，但可通过启用Unused symbols检查（勾选Unused local variable、Report variables used only for writing等）、调高敏感度实现精准定位与批量高亮；需配合Inspect Code…全量扫描导出CSV报告，人工核对后手动删除，以确保安全。
PhpStorm 不能一键删除未使用的变量，但能精准定位、批量高亮，并支持安全批量删减——关键在 Inspection 配置和手动确认环节。
启用并调优 Unused symbols 检查
默认的 Unused local variable 检查常被低估或误关，导致变量“隐身”。必须手动开启并调整敏感度：
- 打开
Settings → Editor → Inspections → PHP → Unused symbols - 勾选
Unused local variable和Unused parameter - 务必勾选
Report variables used only for writing（揪出$tmp = $x * 2;后再没读取的变量） - 取消勾选
Report unused array keys，除非你真要检查字面量数组里写死的 key - 注意：类属性如
private $cache;不会在此处标出，它属于“未使用类成员”，需单独开启Unused private field检查
为什么 foreach 里的 $item 总被误标？
常见现象：foreach ($items as $item) { process($item); } 中的 $item 被标黄，但实际已用。这不是 bug，而是静态分析“读取识别”失效：
- 检查
Settings → Languages & Frameworks → PHP中的 Language Level 是否匹配项目真实版本（如 PHP 8.2），低版本不解析短闭包、解构赋值等语法，导致读取路径断裂 - 避免在循环内用
extract()或${$key} = $val动态创建变量——这类写法让 PhpStorm 完全无法跟踪变量流向 - 若
$item仅传给一个函数（如log($item)），确保该函数有正确@param注解或已加载对应 stub，否则 PhpStorm 认为“传进去就结束”，忽略副作用
批量导出 + 手动清理才是安全路径
靠编辑器实时高亮容易漏看或误删，尤其涉及魔术方法、子类访问、动态调用时。真正可落地的清理流程是：
立即学习“PHP免费学习笔记（深入）”；
- 右键项目根目录 →
Inspect Code…→ 范围选Whole project，Profile 用Default（确保含 Unused symbols） - 扫描完成后，在
Inspection Results窗口中展开PHP → Unused symbols - 点击右上角
Export to File，选 CSV 格式——导出含文件路径、行号、变量名的列表，方便逐条核对 - 对导出项逐个确认：是否在测试文件中被用到？是否被
__get/__set间接访问？是否只是暂时注释掉？确认无误后再手动删
最易被忽略的一点：unset() 是 PHP 运行时行为，而 PhpStorm 的检查纯属静态分析。两者逻辑不同源——它标出的“未使用”，是你代码里确实没读/没传/没反射调用的变量；但如果你删了它，又在后续某处补了读取逻辑，编辑器不会自动“反悔”。清理永远是“先看、再判、后删”，没有全自动兜底。
