如何通过PHPStorm重构功能安全地移除未使用类，实现代码优化？

本文共计636个文字，预计阅读时间需要3分钟。

《安全删除》是一款能有效帮助您确认这个类是否真的没有被使用的工具，直接删除文件或使用rm命令会遗漏动态调用、字符串拼接、配置注册等隐性引用，导致运行时报错Class not found。

Safe Delete 能发现哪些引用

它不是 grep，而是基于 PhpStorm 的符号解析引擎扫描整个项目：

• 正常 new MyClass()、use MyClass、class_exists('MyClass')
• PHPDoc 中的 @var MyClass、@return MyClass（影响类型推导）
• PHPUnit 测试里对类的显式引用（如 $this->assertInstanceOf(MyClass::class, $obj)）
• 但不会识别：class_exists($className) 中的变量值、eval() 里的字符串、YAML/JSON 配置中写的类名（除非你开了「Search in comments and strings」）

执行 Safe Delete 前必须检查的三件事

否则容易跳过警告、误删或漏报：

• 确保类文件本身没有语法错误——PhpStorm 解析失败时会静默跳过引用分析
• 检查是否在 trait 或接口中被 use 或 implements，这类关系有时不显示在「Usages Detected」窗口里，需手动点开 trait 查看
• 打开 File → Settings → Editor → Inspections → PHP → Undefined class，确认该类名当前是红色波浪线（说明 IDE 已识别为未定义），否则 Safe Delete 可能不触发

删除后残留的常见问题与处理

即使 Safe Delete 显示“无引用”，仍可能有运行时隐患：

立即学习“PHP免费学习笔记（深入）”；

• Class 'MyClass' not found 报错出现在 CLI 命令或队列任务中？检查 bin/ 目录下的脚本或 config/packages/* YAML 文件，它们常被 IDE 忽略
• 命名空间别名残留：比如 use App\Old\MyClass as LegacyClass; 没被删，Safe Delete 不会追踪 alias 使用，得手动搜 LegacyClass
• 删除后 composer dump-autoload 失败？说明还有 autoload 配置（如 psr-4 映射）指向旧路径，删完类要同步清理 composer.json

最危险的不是 Safe Delete 找不到引用，而是你默认它已经找全了——动态加载、配置驱动、测试桩这些地方，永远得靠人工交叉验证。