正确搜索PHP函数声明需用\bfunction\s+(\w+)\s*\(，并启用正则模式（蓝色.*图标）、. matches newline，Scope设为All Places，File mask设为*.php；替换时确保关闭Match case、正确使用$1、字面$写为$$。
搜索函数声明必须加单词边界和括号锚点
直接搜 function\s+\w+ 会匹配到注释、字符串、甚至类名里的 function 字样。真正能稳定定位函数定义的写法，得用 \bfunction\s+(\w+)\s*\( ——\b 防止匹配到 public function 前面的单词（比如 interface），\s*\( 确保后面紧跟着左括号，排除掉 function_name 这类变量。
常见错误现象：写 function\s+\w+ 却在 /** @var function $cb */ 里被误中；或搜不到换行写的
function<br> myMethod，因为默认
. 不匹配换行符。
- 务必点击搜索框右下角的
.*图标启用正则模式，灰色=关闭，蓝色=开启 - 如果函数体跨多行，勾选
. matches newline（图标是\n） - 想排除 trait 或 interface 里的伪函数，可加负向先行断言：
\b(?
全局搜函数但没结果？先检查 Scope 和 File mask
搜 \bfunction\s+(\w+)\s*\( 却返回空，大概率不是正则写错，而是作用域或文件类型限制太严。PhpStorm 默认的 Scope 是 Open Files，vendor/ 目录、测试文件、配置文件全被跳过。
典型场景：想批量查项目里所有 validate* 方法，却漏掉了 app/Http/Requests 下的 FormRequest 类——因为 Scope 没切到 All Places 或自定义路径。
立即学习“PHP免费学习笔记（深入）”；
- 右上角 Scope 必须设为
All Places或手动添加目录（如app/） - 底部
File mask填*.php，否则正则会在.js、.json里乱跑，还可能报Invalid regex for file type - 别信“已打开文件”——哪怕你刚编辑过目标文件，
Find in Path仍按 Scope 走，不自动包含
替换函数签名时 $1 引用失效的三大原因
$1 在替换字段里原样输出，不是语法错，是环境没配对。PhpStorm 的正则替换只在正则模式下解析 $1，其他时候它就是普通字符。
最常踩的坑：开了正则，但 Match case 也开着，导致 function 和 Function 被当不同模式，捕获组压根没触发；或者在 Replace 标签页输完正则，却没切回 Find 标签页重新输入，旧缓存残留。
- 确认
.*图标是蓝色，且当前在Find标签页重新键入正则 - 关掉
Match case，除非你明确要区分大小写（比如只改public function，不碰PRIVATE FUNCTION） - 替换内容里要输出字面
$，得写成$$；命名捕获组（如(?<name>\w+)</name>）不支持，只能用$1、$2
跨行函数体匹配必须显式控制贪婪度
想提取整个 if 块或函数体，写 function\s+\w+\s*{.*} 极易翻车：默认 .* 是贪婪的，会从第一个 { 一路吃到文件末尾最后一个 }，中间所有嵌套结构全被吞掉。
安全做法是用否定字符集替代 .*，比如 function\s+(\w+)\s*{([^}]*?)} —— [^}]*? 表示“非 } 字符的最小匹配”，能停在最近的 } 上。但注意：这依然无法处理 if { ... if { ... } ... } 这类嵌套，正则本身不支持平衡匹配。
- 必须勾选
. matches newline，否则{[^}]*?}在多行函数里根本走不完 - 复杂嵌套逻辑（如带
else if的长函数）建议改用 Structural Search（Ctrl+Shift+Alt+S），别硬扛正则 - 替换前务必点
Find预览，看实际高亮范围是否符合预期——跳过这步，等于把$1当骰子摇
