PhpStorm不能一键删除未使用变量，但能通过启用并调优Unused symbols检查（勾选Unused local variable、Report variables used only for writing等）、Whole project级Inspect Code扫描导出CSV、人工核对后手动删除来安全清理。
PhpStorm 无法自动识别所有死代码，但能精准标出大部分未读取的变量、函数和参数——关键在 Inspection 配置是否开全、扫描范围是否覆盖全局、人工核对是否到位。
启用 Unused symbols 检查并调高敏感度
默认设置下，Unused local variable 和 Unused parameter 常被关闭或设为弱警告，导致大量死代码“隐身”。必须手动打开并强化识别逻辑：
- 进入
Settings → Editor → Inspections → PHP → Unused symbols - 勾选
Unused local variable、Unused parameter - 务必勾选
Report variables used only for writing（捕获$tmp = json_encode($data);这类写完即弃的变量） - 取消勾选
Report unused array keys，除非你真在检查字面量数组里的硬编码 key - 类属性（如
private $cache;）不会在此处标灰，需单独开启Unused private field检查
解决 foreach 中 $item 被误标为未使用
常见现象：foreach ($items as $item) { process($item); } 里 $item 变灰，但实际已用。这不是误报，是静态分析断链：
- 检查
Settings → Languages & Frameworks → PHP → Language Level是否匹配项目真实版本（如 PHP 8.2），低版本不解析短闭包、解构赋值等语法 - 避免在循环内用
extract()或${$key} = $val—— PhpStorm 完全无法跟踪这类动态变量 - 若
$item只传给一个函数（如log($item)），确保该函数有正确@param注解或已加载对应 stub，否则 PhpStorm 认为“传进去就结束”
用 Inspect Code… 全局扫描 + 导出 CSV 核对
靠编辑器内实时高亮容易漏看，尤其涉及魔术方法、子类访问、动态调用时。真正可落地的清理路径是：
立即学习“PHP免费学习笔记（深入）”；
- 右键项目根目录 →
Inspect Code…→ 范围选Whole project，Profile 用Default（确保含Unused symbols） - 扫描完成后，在
Inspection Results窗口中展开PHP → Unused symbols - 点击右上角
Export to File，导出为 CSV —— 包含文件路径、行号、变量/函数名，方便排序和逐条确认 - 逐条核对：是否在
tests/下？是否被注释块包裹？是否出现在 YAML/JSON 配置的类名字符串里？是否被__get()间接访问？
Safe Delete 类时必须交叉验证动态引用
Safe Delete 是唯一能基于符号解析引擎扫描显式引用的方式，但它天然漏掉运行时动态加载场景：
- 它能识别
new MyClass()、use MyClass、class_exists('MyClass')、PHPDoc 中的@var MyClass - 它不能识别：
class_exists($className)中的变量值、eval()字符串、YAML/JSON 配置中写的类名（除非你开了Search in comments and strings） - 执行前务必检查：
File → Settings → Editor → Inspections → PHP → Undefined class，确认该类名当前是红色波浪线（说明 IDE 已识别为未定义），否则Safe Delete不触发 - 删完后仍要人工查：
bin/脚本、config/packages/*.yml、composer.json中的 autoload 映射，以及命名空间别名（如use App\Old\MyClass as LegacyClass;）
最危险的不是工具没找到引用，而是你默认它已经找全了——unset() 是运行时行为，__set() 是魔术逻辑，ReflectionProperty 是反射调用，这些地方永远得靠人工交叉验证。
