phpstorm 不标灰未调用函数是设计使然，因 php 支持动态调用（如 call_user_func、字符串调用），静态分析无法覆盖；它默认不检查顶层 function 声明，仅对局部变量和参数做未使用检测。
PhpStorm 不能直接“搜索未调用函数”并一键删掉，它不提供类似 WebStorm 对 Unused function 的 Inspection 支持；你看到的灰色函数名，大概率只是未被当前文件引用，而非全项目未调用——尤其当函数被动态调用、魔术方法触发、或通过字符串类名加载时，静态分析会完全失效。
为什么 PhpStorm 不标灰未调用的函数声明
PhpStorm 的函数使用检测逻辑和 WebStorm / VS Code 不同：它默认只标记 Unused local variable 和 Unused parameter，但对顶层 function foo() {} 声明不做未调用检查。这不是漏配，是设计如此——PHP 天然支持 call_user_func('foo')、$func = 'foo'; $func()、路由映射、事件监听器等运行时绑定方式，静态分析无法覆盖。
- 即使你手动开启
Unused symbols检查，Unused function选项在 PHP 语言下根本不会出现在 Inspection 列表里 - 类中
private function可能被标灰，但仅限于当前类内未被显式调用（不跨继承链、不进魔术方法） -
public function几乎从不被标灰，因为 IDE 默认认为它可能被子类、反射、测试或框架调用
真正能落地的“找未调用函数”路径
别依赖实时高亮，要靠全局扫描 + 人工交叉验证。关键不是“找到”，而是“确认没被任何方式调用”：
- 右键项目根目录 →
Inspect Code…→ 范围选Whole project→ Profile 用Default - 扫描完展开左侧
PHP → Unused symbols，重点看Unused private field和Unused local variable，它们有时会连带暴露孤立函数上下文 - 导出结果为 CSV 后，用文本工具筛选含
function关键字的行，再逐个打开对应文件，搜function_name(、'function_name'、"function_name"、->function_name(、::function_name( - 特别注意配置文件（YAML/JSON）、路由定义（如 Laravel
routes/web.php）、事件监听器数组、以及__call/__callStatic中的字符串匹配逻辑
Safe Delete 是唯一接近“确认未调用”的操作
对某个疑似无用的函数名右键 → Safe Delete，PhpStorm 会基于符号解析引擎列出所有显式引用点（包括 use function、类内调用、继承重写）。但它天然跳过：
- 字符串拼接调用：
$name = 'handle' . $event; $name(); - 反射调用：
new ReflectionFunction('foo') - 配置驱动调用：
['handler' => 'App\Handlers\FooHandler']中的类方法 - 注释块里的伪调用：
// @see foo()不算引用
如果 Safe Delete 弹窗显示 “No usages found”，别急着删——先全局搜该函数名是否出现在字符串、注释、配置或测试文件里。最容易被忽略的是：函数名作为数组键、日志上下文字段、或错误码映射表的值，这些都不会被符号解析捕获。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
