PhpStorm通过启用Unused symbols检查并调高敏感度来快速标出未使用变量，需配置Settings→Editor→Inspections→PHP→Unused symbols，勾选Unused local variable和Report variables used only for writing等选项。
PhpStorm 怎么快速标出未使用的变量
PhpStorm 本身不提供“一键删除”未使用变量的功能，但能实时高亮并批量定位——关键在启用 Unused symbol 检查并调高其敏感度。
默认情况下，部分变量（比如数组键、动态属性赋值、反射调用中的变量）会被误判为“已使用”，需要手动调整检查范围。
- 打开
Settings → Editor → Inspections → PHP → Unused symbols，勾选Unused local variable和Unused parameter - 取消勾选
Report unused array keys（除非你明确需要检查数组字面量里的 key） - 勾选
Report variables used only for writing，它能揪出类似$tmp = $x * 2;后再没读取的变量 - 注意：类属性（
private $cache;）即使没在当前文件中读写，也可能被子类或魔术方法访问，PhpStorm 默认不报，需配合Code → Inspect Code…全局扫描才可能发现
为什么 foreach 里的变量总被误标为未使用
常见于 foreach ($items as $item) { ... } 中的 $item 被标黄，实际却在循环体内用了——这通常是因为 PhpStorm 没识别到变量被“读取”，尤其当读取发生在函数调用、闭包或条件分支深处时。
- 检查是否启用了
PHP Language Level匹配项目实际版本（Settings → Languages & Frameworks → PHP），低版本可能无法解析短闭包或解构语法 - 避免在循环内用
extract()或${$key} = $val;动态创建变量，这类写法会让静态分析彻底失效 - 如果变量仅用于传递给一个函数（如
log($item);），确保该函数声明了@param注解或有正确的 stub，否则 PhpStorm 可能认为“传进去就结束了”，忽略后续副作用
用 Code → Inspect Code… 批量导出未使用变量列表
想生成可审查的报告（比如发给同事核对），不能只靠编辑器高亮——得走全量扫描流程，且要排除误报干扰。
立即学习“PHP免费学习笔记（深入）”；
- 右键项目根目录 →
Inspect Code…→ 范围选Whole project，Profile 选Default（确保包含Unused symbols） - 扫描完成后，在
Inspection Results窗口中展开PHP → Unused symbols，点击右上角Export to File，选CSV格式 - 导出的 CSV 里会包含文件路径、行号、变量名和问题描述，但注意：
$this->prop类型不会出现在这里，它属于“未使用类成员”，需单独开启Unused private field检查 - 若项目含大量测试文件（
*Test.php），建议先在 Inspection 设置中添加 scope 排除tests/**，否则断言变量常被误报
删除前务必确认作用域和运行时行为
静态分析工具无法理解 eval、__get/__set、__call、依赖注入容器自动绑定等动态逻辑。一个被标红的变量，删掉后可能让代码在运行时报 Undefined variable。
- 对
compact()、extract()、with()、Blade 的@props等上下文传递场景，一律跳过自动清理 - 检查变量是否出现在注释里被文档工具（如 phpDocumentor）引用，例如
// @var User $user—— 这类不会触发警告，但删掉会影响类型提示 - 如果变量名是
$i、$j、$data等泛化命名，优先人工确认而非批量替换；它们常作为占位符存在，删掉反而破坏可读性
最稳妥的做法：先用 Inspection 导出列表，逐个打开文件，看变量是否出现在 isset()、empty()、array_key_exists() 或字符串拼接中——这些地方容易漏判“使用”。
