函数名搜不到主因是符号索引未生成或卡住，应先执行reload project from disk同步文件结构，无效则invalidate caches and restart重建索引；同时确认文件类型为php、目录未被排除、作用域设为project、php语言级别匹配且composer autoload已正确配置并标记为include root。
函数名搜不到，大概率是索引没建好或卡住了
双击 Shift 搜 array_filter 或自定义函数名没结果，不是快捷键失效，而是 PhpStorm 的符号索引（symbols index）压根没生成或中途崩了。右下角状态栏如果长期显示 Indexing…、Scanning files…，或者干脆没任何提示，就说明索引进程异常。这时候哪怕代码写得再对，IDE 也“看不见”函数声明。
先试最轻量的同步操作：File → Reload project from Disk。它不删缓存，只强制重读当前磁盘文件结构，并尝试对齐已有索引。5 秒完成，适合 Git 切分支后、新增了 app/Helpers/ 目录但没自动识别这类场景。
若 Reload 后仍无响应，或右下角直接不出现索引提示，就得走重建流程：File → Invalidate Caches and Restart → Invalidate and Restart。这会清掉 .idea/caches/ 和 .idea/index/，重启后首次打开会明显变慢——这是正常重建过程，别中断。
函数被识别为文本，不是 PHP 符号
右键点击含函数定义的文件（比如 helpers.php），选 Override File Type → PHP。如果这个文件被误标为 Text files，PhpStorm 就只当它是纯文本，不会解析其中的 function foo() 声明，自然无法纳入函数搜索范围。
检查路径是否被排除：进入 Settings → Directories，确认 app/、src/、helpers/ 这类实际存放函数的目录没被标成 Excluded（红色图标）。一旦排除，连带里面的函数定义也会从索引中剔除。
多模块项目（如 monorepo 中的 packages/utils/src/）需手动添加到索引范围：在全局搜索框点 Scope → Edit Scopes → Add → Directory，选中对应路径。否则这些目录下的函数名永远不会出现在 Search Everywhere 结果里。
作用域和前缀语法用错，搜出来的根本不是函数
Search Everywhere（双击 Shift）默认返回混杂结果：文件、类、设置项、方法……全堆在一起。输 UserRepository 可能优先跳出配置文件里的字符串，而不是你想要的类。
加前缀直奔函数类型：func array_map 或 function my_custom_helper。注意空格是分隔符，funcarray_map 不会匹配。
Scope 设置也有影响：如果当前 Scope 是 Current File 或 Open Files，即使函数真实存在，也不会被纳入搜索队列。必须确保 Scope 是 Project 或已包含函数所在目录的自定义范围。
另外，PHP 语言级别不匹配也会导致函数不进索引。比如用了 mixed 类型（PHP 8.0+），但 Settings → Languages & Frameworks → PHP 里设的是 PHP 7.4，IDE 会跳过整个文件的符号解析——函数名当然搜不到。
Composer 自动加载未生效，自定义函数进不了索引
函数定义在 composer.json 的 "autoload": {"files": ["helpers.php"]} 里？那必须确保两件事都做了：
- 运行过
composer dump-autoload，生成最新的vendor/autoload.php - 在 PhpStorm 中右键点击
vendor/autoload.php→Mark as PHP Include Root
只做第一步，命令行能跑通，但 IDE 不知道该加载哪些文件；只做第二步，autoload.php 本身没更新，新函数还是不会被识别。
还要留意大小写：Linux 系统下 Helpers.php 和 helpers.php 是两个文件，但 PhpStorm 默认按大小写敏感方式索引。如果 composer.json 写的是 "files": ["Helpers.php"]，而实际文件叫 helpers.php，索引就会漏掉整批函数。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
