PhpStorm 中文搜索失效的根源是文件类型误标为Text、编码非UTF-8、关键目录被Excluded或索引未完成；需依次检查并修正文件类型、统一设为UTF-8编码、取消目录排除、等待或重建索引。
PhpStorm 里搜“用户管理”“订单列表”这类中文词没结果，不是搜索功能坏了，而是它根本没把 PHP 文件当 PHP 处理——类名、方法名、注释里的中文全进不了 AST 索引，只当普通文本扫一遍，自然匹配不上。
文件类型被误标为 Text，PHP 结构索引失效
右键一个含中文类名的 .php 文件 → 看 “Override File Type” 菜单项是否显示为 Text。如果是，说明 PhpStorm 没把它当 PHP 解析，class UserController 和 /** @var 用户信息 */ 都不会进语义索引，只走字面匹配（且受编码限制）。
- 立刻执行：右键该文件 →
Override File Type → PHP - 批量修复：Settings → Editor → File Types → 找到
PHP files列表，确认*.php在里面；如果它躺在Text files或Auto-detect下，拖进去或手动添加 - 验证效果：Ctrl+F 在该文件内搜“用户”，能搜到 → 类型已对；搜不到 → 编码可能也有问题
文件编码不是 UTF-8，中文字符无法被索引识别
即使文件类型正确，若保存编码是 GBK、GB2312 或 ANSI，PhpStorm 读取时会乱码，索引层看到的是 字符，后续任何搜索都失效。
- 右键目标文件 →
Reload file with encoding → UTF-8，并勾选Convert（这步会真实转码保存） - 检查项目默认编码：Settings → Editor → File Encodings →
Global Encoding和Project Encoding都设为UTF-8，且Default encoding for properties files也保持一致 - 新建文件时自动用 UTF-8：勾选
Transparent native-to-ascii conversion可避免 .properties 类文件出问题，但 PHP 文件不依赖此项
作用域里关键目录被 exclude，整个命名空间消失
搜“用户管理”没结果，但你知道代码就在 src/Controller/UserController.php？大概率是 src 目录被标成了 Excluded（红色图标），它和子目录下的所有 PHP 文件一起被踢出索引队列。
立即学习“PHP免费学习笔记（深入）”；
- 打开 Settings → Project → Directories，逐个检查
src、app、packages等实际放业务代码的路径 - 看到红色
Excluded标签？点击右侧下拉菜单 → 改成Sources或Resources - 多模块项目（如 Lerna/Yarn Workspaces）需额外操作：Edit Scopes → 添加对应
packages/*/src路径，否则packages/user-service根本不扫描
索引未完成或已损坏，所有搜索都不可信
右下角状态栏没显示 Indexing completed，或者一直卡在 Indexing…，那别试任何搜索技巧——此时 Ctrl+Shift+F、双击 Shift、Ctrl+N 全部无效，因为底层数据根本没建好。
- 先等：如果刚开项目或切了 Git 分支，索引可能只是慢，等它自己完成
- 强制同步：File →
Reload project from Disk（5 秒内完成，只刷新文件列表，不删索引） - 彻底重建：File →
Invalidate Caches and Restart…→Invalidate and Restart（清掉.idea/index/，重启后重新建库，耗时较长但最可靠） - 千万别手动删
.idea/index/后再开项目——这会让 PhpStorm 以为索引还在，实际却空着，搜索永远返回空
拼音搜索失效背后真正卡住的，往往不是“搜中文”这个动作本身，而是文件没被识别为 PHP、编码不是 UTF-8、目录被 exclude、或者索引压根没起来——四个环节只要断一环，中文就搜不到。动手前先看右下角那个小提示，比调一百遍设置都管用。
