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 前必须检查的三件事

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

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

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

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

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

• 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 找不到引用，而是你默认它已经找全了——动态加载、配置驱动、测试桩这些地方，永远得靠人工交叉验证。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！