PhpStorm的Find in Path常漏匹配，因默认范围、大小写/全词设置、文件掩码、编码不一致及目录排除等配置未调优。
PhpStorm 的搜索功能不是“开箱即用就全对”的，很多参数不调好，Find in Path 会漏匹配、Replace in Path 会误替换、正则表达式会失效，甚至结构化搜索根本找不到目标代码结构。
为什么 Find in Path 找不到你明明写过的字符串
常见现象：在项目里搜 user_id，但类中 public $user_id; 没被高亮；或者搜 ->save() 却只匹配到注释里的文字。
- 默认搜索范围是
Project，但如果你当前打开了某个模块或自定义范围，实际生效的可能是它——务必在Find in Path对话框右上角确认Search scope显示的是你预期的范围 -
Match case（大小写敏感）和Words only（全词匹配）默认关闭，但一旦开启，userId就不会匹配$user_id，因为下划线不是单词边界 - PHP 文件默认启用
File mask为*.php，但如果你改过设置（比如加了*.inc或删了），模板文件、配置数组里的字符串就可能被跳过 - 如果目标文本在注释或字符串字面量中，而你勾选了
Text模式（非正则），它仍会被找到；但若用了正则且没加s修饰符，跨行内容就无法匹配
Replace in Path 时反斜杠和正则引用怎么写才不翻车
错误示例：想把 echo "hello"; 替成 error_log("hello");，结果替完变成 error_log("hello"); —— 多了个转义反斜杠。
- 在
Replace in Path的替换字段里，是特殊字符，要表示字面意义的反斜杠，必须写成\\（四个反斜杠）：前两个组成一个转义序列传给 IDE，后两个再组成一个传给正则引擎 - 正则捕获组引用统一用
$1、$2，不是或$0；$0在 PhpStorm 里无效，会原样输出字符串$0 - 如果搜索用了命名捕获组，比如
(?<key>w+):，替换时不能用$key，必须用编号$1——PhpStorm 不支持命名引用 - 启用
Regex后，搜索字段里所有.、+、?等都按正则解释，别忘了给字面点号加.，否则会误匹配任意字符
结构化搜索（SSR）模板里变量过滤器的实际效果
你以为设了 $func$ 变量 + Text 过滤器 ^[a-z] 就能筛出小写开头的方法名？不一定。这个过滤器只作用于变量“文本内容”，不校验语法角色。
立即学习“PHP免费学习笔记（深入）”；
-
$func$默认匹配任意标识符，包括变量名、函数名、类名；加过滤器^[a-z]后，它仍可能匹配到$foo（变量）或bar()（函数调用），只要名字本身小写开头 - 真正控制“只能是方法名”的，是模板上下文：比如用预置模板
PHP | Methods | Public method，它底层绑定了 AST 节点类型，比纯文本过滤可靠得多 - 递归选项影响嵌套结构识别：关掉
Recursive，if (is_array($x)) { ... }里的is_array能被找到；但array_filter($arr, function($x) { return is_numeric($x); })里的内层is_numeric就会被忽略 - “注入代码”开关决定是否搜索 HTML 中的
<script>或 PHP 字符串里的 SQL 片段——开它会让 SSR 变慢，但处理混合模板时不可少
搜索性能卡顿或结果不准时该查哪几个隐藏开关
搜一个简单字符串，进度条卡住 10 秒，或者结果里混进 vendor 目录的文件，八成是这几个地方没清理干净。
- 检查
Settings | Editor | File Encodings：如果项目含 GBK 编码的旧文件，而 IDE 默认用 UTF-8 解析，搜索会跳过那些文件——把Default encoding for properties files和Global encoding统一设为UTF-8 - 排除目录必须在
Settings | Directories里设为Excluded，仅靠Find in Path对话框里的Scope自定义范围过滤，vendor 里的匹配仍会出现（只是不显示路径） -
Settings | Editor | General | Search下的Highlight on caret movement如果开启，光标移动时实时高亮会拖慢响应；大项目建议关闭 - 结构化搜索的缓存存在内存里，改过模板后不重启 IDE，旧结果可能残留；遇到“改了条件却没生效”，先点
Clear cache and restart（File | Invalidate Caches and Restart）
最常被忽略的是：搜索范围和文件编码的耦合关系——哪怕你明确选了 Project，只要某个子目录被标记为 Excluded 或编码不匹配，它就彻底从搜索索引里消失了，连“没找到”都不会提示。
