Search Everywhere 搜不到变量名，首要检查索引是否完成及配置是否正确：需确保项目根目录打开、关键目录未被Excluded、PHP语言级别匹配代码语法、文件类型识别为PHP，并在Search Everywhere中使用sym $user前缀精准搜索变量。
Search Everywhere 搜不到变量名？先看索引有没有建好
搜 UserService 或 $user 没结果，大概率不是快捷键按错，而是 PhpStorm 还没把符号解析进索引。右下角状态栏如果显示 Indexing... 或卡在 Scanning files...，就别急着搜——等它跑完再试。
常见干扰项包括：
- 项目根目录没打开：从子目录（如
public/）直接打开项目，src/和vendor/不会被纳入索引范围 - 目录被误设为 Excluded：Settings → Directories 里检查是否把
app、src或tests加进了排除列表 - PHP 语言级别不匹配：Settings → Languages & Frameworks → PHP 设成 7.4，但代码用了 8.2 的只读属性，类和变量就不会被识别
- 文件类型没识别：右键某个
.php文件 → Override File Type → 选PHP，否则不会进符号索引
搜变量必须用 sym 前缀，否则默认不查符号
双击 Shift 打开 Search Everywhere 后，直接输 UserService 是查类名，输 handleRequest 是查方法，但输 $user 或 USER_ROLE 默认不会命中变量——因为默认搜索范围是“所有类型混排”，变量权重低，且不支持 $ 符号前缀匹配。
要精准搜变量，必须加前缀：
立即学习“PHP免费学习笔记（深入）”；
-
sym $user→ 查局部变量或参数 -
sym USER_ROLE→ 查常量（含define()和const） -
sym config→ 查全局变量（如$config）、类属性、静态属性
注意：sym 不区分大小写，但空格是分隔符；symuser 不会匹配 $user；sym user 可能匹配到方法名或类名，不如加 $ 更准。
Ctrl+Shift+Alt+N 真的能搜变量？不，它只搜类中符号
Ctrl+Shift+Alt+N（Windows/Linux）或 Cmd+Shift+Alt+N（macOS）不是全局变量搜索快捷键，它的作用范围严格限定在“当前已打开的类文件内”——也就是只搜这个类定义里的方法、属性、常量，不跨文件，也不管 use 引入的 trait 或父类成员。
所以：
- 想查
UserRepository类里的$cache属性？可以用Ctrl+Shift+Alt+N - 想查整个项目里所有叫
$cache的变量？必须用sym $cache+ Search Everywhere - 想查某个变量在哪被赋值或修改？右键变量 →
Find Usages（Alt+F7），不是搜，是追踪引用
符号搜索慢、结果不准？关掉“Skip indexing for folders with name”
如果你项目里用了软链接（symlinks）指向 vendor 或自定义模块目录，而 Settings → Editor → File Types 里又勾了 Skip indexing for folders with name 并填了 vendor，那这些链接目录下的符号根本不会进索引——sym 搜索自然为空。
解决办法很简单：
- 进 Settings → Editor → File Types
- 找到
Skip indexing for folders with name列表 - 删掉
vendor、node_modules等你实际需要索引的软链目录名（PhpStorm 本身对vendor有优化，一般不用手动跳过） - 重启索引：File → Reload project from Disk 或右下角索引条 → 齿轮图标 →
Rebuild Index
变量搜索不像文件名搜索那么“直觉”，它依赖解析精度和索引完整性。哪怕只是少一个 use 语句、PHP 版本设低一级、或者软链目录被跳过，sym 就可能返回空——这不是功能失效，是上下文没对齐。
