phpstorm不内置废弃函数检测，需通过inspection配置+phpstan/psalm集成实现：设对php语言版本、启用deprecated检查、全局搜@deprecated注释并右键find usages，配合终端grep补漏和测试验证确保无误。
直接搜不到废弃函数，是因为 PhpStorm 不会自动标记“已弃用但还能用”的函数——它只响应你明确配置的检查规则或手动触发的语义扫描。光靠 Ctrl+Shift+F 搜 @deprecated 注释或函数名，漏掉动态调用、字符串类名、第三方扩展里的废弃入口，90% 的废弃逻辑根本扫不出来。
怎么让 PhpStorm 主动标出废弃函数
PhpStorm 本身不内置“废弃函数检测”，得靠 Inspection + PHPStan / Psalm 集成双保险：
- Settings → Editor → Inspections → PHP → PHP language level 必须设为项目真实版本（如 PHP 8.2），否则无法识别
#[Deprecated]属性语法 - 勾选
Unused symbol下的Unused private method和Unused public method，但注意：这只能标出“完全没被调用”的函数，不是“官方已废弃”的函数 - 真正识别
@deprecated或#[Deprecated]，必须启用 PHPStan：File → Settings → Languages & Frameworks → PHP → PHPStan → Enable，路径填vendor/bin/phpstan，Level 设为 7 或更高 - Psalm 更细：Settings → PHP → Psalm → Enable，配置
psalm.xml中<issuehandlers><deprecatedmethod></deprecatedmethod></issuehandlers>开启告警
全局搜废弃函数声明的实操要点
搜 @deprecated 注释本身容易，但关键是要连带把调用点一起揪出来：
- 按
Ctrl+Shift+F，输入@deprecated，Scope 选Project，File mask 填*.php - 搜完后别急着关窗口，在结果列表里右键某条匹配 →
Find Usages，它会列出所有调用该函数的位置（前提是函数已被索引） - 如果右键没反应，说明该函数定义在
require_once 'helpers/old.php'这类非标准路径下——去 Settings → PHP → Include Paths 手动加进去 - 搜
#[Deprecated]要注意：PHP 8.2+ 才支持，且必须是单行写法#[Deprecated("use newMethod instead")]；写成多行或带换行会被正则漏掉
替换废弃函数时最常踩的三个坑
批量替换不是改名字那么简单，尤其涉及框架方法、魔术方法、动态调用：
-
Ctrl+Shift+R替换前，务必勾选Words only和Match case：比如把findWhere换成where，不加Words only会把findWhereIn也卷进去 - 动态调用永远逃过重构：如
call_user_func([$obj, $method])、$obj->{$methodName}()、app('OldService')—— 这些必须用Ctrl+Shift+F全局搜原函数名字符串，人工确认 - 测试文件里经常藏着废弃调用：
tests/Feature/UserTest.php里可能还用着$this->seeJson()（Laravel 5.x 废弃），但 Inspection 默认不扫tests/目录，得手动把 Scope 扩展进去
安全删废弃函数前必须交叉验证的两件事
删函数比改名风险更高，因为 Safe Delete 只查静态引用，漏掉的全是运行时黑盒：
- 执行 Safe Delete 前，先跑一遍
phpunit --filter=.*，看有没有测试因调用废弃函数而失败；失败项里出现的调用链，就是 Inspection 没扫到的盲区 - 用
grep -r "oldFunctionName" --include="*.php" . | grep -v "vendor/"终端补漏：IDE 索引有时跳过 symlink 目录或临时生成的cache/文件，终端命令更可靠 - 删完别忘了清 Composer autoloader：
composer dump-autoload -o，否则旧函数名仍可能从autoload_classmap.php里被加载出来
真正难的从来不是找到废弃函数，而是确认它“真的没人用了”——尤其当项目混用 Laravel Dusk、Livewire、自定义宏、甚至 PHP 扩展时，静态分析的边界很清晰，但运行时的调用路径永远藏得更深一点。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
