搜索无结果首要检查右下角是否显示“Indexing completed”，索引未完成或损坏会导致Ctrl+Shift+F、Ctrl+Shift+N及双击Shift全部失效；需点击索引条齿轮→Rebuild Index，或执行File→Invalidate Caches and Restart。
搜索完全没结果？先看右下角有没有“Indexing completed”
搜不到不是设置错了，是索引根本没建好。PhpStorm 的 Ctrl+Shift+F、Ctrl+Shift+N、双击 Shift 全部依赖后台索引，一旦中断或损坏，所有搜索都变摆设。
检查右下角状态栏：如果显示 Indexing…、Scanning files… 或压根没提示，就别调设置，先等或强制重建索引。
- 点索引条右侧齿轮图标 →
Rebuild Index（比Reload project from Disk更彻底） - 若卡住或反复失败，直接执行
File → Invalidate Caches and Restart… → Invalidate and Restart - 重建期间别操作项目，尤其别删
.idea/index/下的文件——那是索引库本体，手动删等于自毁
作用域选成 “Project” 但还是搜不到？检查目录是否被 exclude
默认的 Project scope 看似全量，实则自动跳过所有标为 Excluded 的目录。而 vendor、node_modules、dist 这些目录，只要右键点过 Mark Directory as → Excluded，就彻底退出搜索队列。
- 进
Settings → Directories，逐个确认src、app、packages等关键路径没被误标为Excluded -
Excluded和Ignored不同：Ignored是 Git 层面，Excluded是 PhpStorm 索引层，后者才真正屏蔽搜索 - 多模块项目（如 Lerna/Yarn Workspaces）需手动在
Edit Scopes里添加对应路径，否则packages/foo根本不进扫描范围
中文、类名、方法名搜不到？文件类型和编码可能没对上
Ctrl+F 在单文件里能搜到中文，但全局搜不到，90% 是因为文件没被识别为 PHP，或编码不是 UTF-8。
立即学习“PHP免费学习笔记（深入）”；
- 右键目标文件 →
Override File Type → PHP，否则class UserRepository不会进 AST 索引，只当普通文本扫 -
Ctrl+F在该文件内试搜中文：能搜到 → 编码 OK；搜不到 → 右键 →Reload file with encoding → UTF-8并勾选Convert - 进
Settings → Editor → File Types，确认*.php在PHP files列表里，而不是躺在Text files或Auto-detect下
正则搜索失效或替换错乱？别漏掉三个硬开关
正则不是开个选项就完事，Find in Path 里它有三道闸门，缺一不可。
- 必须点击搜索框右下角
.*图标（变蓝才算激活），快捷键Ctrl+Alt+R有时被系统占用，不能信 - 跨行匹配要勾选
. matches newline（图标是\n），否则public.*function永远停在第一行末尾 - 替换时写
$1引用捕获组，但$符号本身要输出得写成$$，否则会被当变量解析
最常被忽略的是：正则生效的前提是作用域没锁死在 Open Files，且 File mask 填了 *.php —— 否则它会在 .log 和 .zip 里徒劳地跑正则，还报 Invalid regex for file type。
