Safe Delete能基于符号解析引擎扫描整个项目识别显式引用，但无法识别变量类名、eval()、YAML/JSON配置等动态引用，需人工交叉验证。
Safe Delete 是唯一能真正帮你确认“这个类是否真没被用”的方式，直接删文件或 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 找不到引用，而是你默认它已经找全了——动态加载、配置驱动、测试桩这些地方，永远得靠人工交叉验证。
