PhpStorm 默认不索引 vendor 或外部库的函数定义，Ctrl+Shift+Alt+N 搜不到 array_map、Str::slug 或 DB::table 这类函数，不是快捷键失效，而是 IDE 根本没把它们当“可解析符号”处理。
为什么 Ctrl+Shift+Alt+N 在 vendor 里搜不到函数
这个快捷键只查当前项目中被标记为 Sources Root 的目录，而 vendor/ 默认是 Excluded（排除索引）——它只参与运行时加载，不参与静态分析。即使你手动点了 Find Usages 或 Go to Declaration，结果也常为空或跳转失败。
- 检查右下角状态栏：如果显示
Indexing…但长时间卡在 “Scanning vendor” 或直接跳过，说明目录已被排除 - 右键
vendor/→ 查看是否标着Excluded（灰色图标），这是默认行为，不是误操作 -
composer install后新增的包不会自动进索引，除非你主动刷新或重载项目 - 第三方包若用 PHP-DI、Laravel Container 等动态注册服务，函数名可能根本不出现在源码中，IDE 无法推断
让外部库函数能被 Ctrl+Shift+Alt+N 搜到的实操步骤
核心是告诉 PhpStorm：“这些外部文件也是代码，要解析、要索引、要参与跳转”。但不能全量开启，否则索引爆炸、内存爆满、搜索变慢。
- 进
Settings → Languages & Frameworks → PHP → Include Paths，点击+添加路径，例如：vendor/laravel/framework/src/Illuminate或vendor/symfony/http-foundation - 不要加整个
vendor/，只加你真正在用、且需要跳转/补全的核心包子目录 - 添加后点右上角
Reload index，等右下角索引进度条走完（通常需 1–3 分钟） - 验证是否生效：光标停在
Str::slug()上按Ctrl+B，应能跳转到vendor/illuminate/support/Str.php；再试Ctrl+Shift+Alt+N搜slug@function，应有结果
搜得到 ≠ 能跳转：动态调用和别名函数的硬伤
即使你把所有 vendor 都加进了 Include Paths，有些函数依然搜不到或跳转失败——这不是配置问题，是静态分析的天然限制。
立即学习“PHP免费学习笔记（深入）”；
-
DB::table()这类 Facade 方法，实际调用链是__callStatic→resolveFacadeInstance→ 动态代理，PhpStorm 不会追踪这层反射 -
use function Illuminate\Support\str_slug;这种函数别名，在 stub 中无对应声明，Ctrl+Shift+Alt+N搜str_slug会失败，但搜Str::slug可能成功 -
call_user_func(['Helper', 'format'])或$obj->{$method}()类型调用，IDE 无法推断目标函数，Find Usages和Call Hierarchy均不覆盖 - PHP 8.4+ 新增的
fn()箭头函数若定义在 vendor 里，且语言级别未设对（如设成 PHP 8.2），Ctrl+Q文档和Ctrl+B跳转都会静默失败
替代方案：不依赖索引也能快速定位外部函数
当索引不可靠或太重时，直接绕过 IDE，用更轻量、更确定的方式查。
- 用
Shift+F1：光标停在任意函数名上（哪怕 vendor 里的），按此键直接打开https://www.php.net/manual/en/function.xxx.php或对应 Laravel/Symfony 文档页，不依赖本地索引 - 终端里
grep -r "function slug" vendor/illuminate/support/，快且准，尤其适合查没被 IDE 正确识别的私有方法 - 在
vendor/目录右键 →Find in Path（Ctrl+Shift+F），Scope 设为Directory，File mask 填*.php，关掉Search in comments and strings避免噪声 - 浏览器访问
https://github.com/laravel/framework/blob/11.x/src/Illuminate/Support/Str.php，用页面Cmd+F搜函数名，比等 IDE 索引更快
真正容易被忽略的是：加 Include Paths 后，Ctrl+Shift+Alt+N 搜索结果里会出现大量重复项（同一函数在多个版本的包里被索引），此时必须用 "slug"（双引号）精确匹配，或加前缀如 Illuminate\Support\Str@function 收敛范围，否则结果列表会淹没真实定义。
