<p>必须手动点亮搜索框右下角的 .* 图标启用正则引擎，否则所有正则表达式均被当作普通字符串处理；图标变蓝不代表生效，需确保在「Find」标签页重新输入且关闭「Match case」以避免大小写干扰捕获组解析。</p>
必须手动点亮搜索框右下角的 .* 图标，否则写再复杂的正则也当普通字符串处理——这是所有“搜不到”“$1 不生效”问题的根因。
为什么全局替换里正则没反应？
PhpStorm 默认关闭正则引擎，Ctrl+Shift+R 打开的「Replace in Path」对话框，哪怕你写了 \bfunction\s+(\w+)\(，只要 .* 图标还是灰色，就只会字面匹配字符串 ".bfunction s+(w+)("。
- 快捷键
Ctrl+Alt+R（Win/Linux）或Cmd+Alt+R（macOS）可快速切换，但图标状态才是唯一可信依据 - 图标变蓝 ≠ 一定生效：如果当前在「Replace」标签页但没切回「Find」重新输入，旧模式可能残留
- 文件掩码（
File mask）填了*.php却仍无结果？先确认.*是否点亮——掩码只过滤后缀，不激活正则
全局替换时捕获组 $1 总是原样输出？
根本不是语法写错，而是正则模式没开，或者「Match case」意外开启导致大小写敏感干扰分组识别。
-
$1只在正则模式下解析；关掉Match case（除非你明确要区分大小写），否则$_POST和$_post会被当成不同模式，捕获失败 - 想把
$_GET['id']换成filter_input(INPUT_GET, 'id')，搜索填\$_GET\['([^']+?)'\]，替换填filter_input(INPUT_GET, '$1')——注意单引号和$1的位置，别漏引号 - 若目标含双引号键名，得另加一条：
\$_GET\["([^"]+?)"\]→filter_input(INPUT_GET, "$1")，不能指望一个正则通吃两种引号
替完代码直接报错？括号/引号失衡是高频翻车点
正则替换不校验语法，它只管字符串层面的拼接。一个漏掉的点号、多出来的空格、错位的引号，都会让 PHP 解析失败。
立即学习“PHP免费学习笔记（深入）”；
- 比如把
echo "Hello $_name";替成echo "Hello " . $name;，少了个空格或连接符，就变成"Hello " $name;—— 语法错误 - 跨行结构（如数组定义、多行字符串）必须勾选
.（Dot matches newline），否则array\(.*?\)到第一行末就停了 - 替换后务必执行
Ctrl+Alt+O（Optimize Imports）+ 手动格式化（Ctrl+Alt+L），再用 PHPStan 或 Psalm 扫一遍，尤其盯住注释块、SQL 片段、模板变量里混着的伪 PHP 代码
最常被跳过的动作是点「Find」预览——不看实际匹配项就点「Replace All」，等于拿正则当盲盒摇。哪怕只是改个命名风格，也要先扫一眼是否误中了 vendor 目录里的第三方类、JSON 配置里的键名、或 SQL 字符串里的字段别名。
