结构化搜索比普通Ctrl+F更有用，因为它基于AST理解PHP语法结构，能精准识别方法调用等语义元素，避免误改字符串或注释中的文本。
结构化搜索为什么比普通 Ctrl+F 更有用
因为普通搜索只匹配文本，而结构化搜索能理解 PHP 语法结构。比如你想把所有 $user->getName() 替换成 $user->name，但又不想误改字符串里或注释里的相同文本——只有结构化搜索能精准识别这是“方法调用”，且接收者是变量、方法名是 getName。
怎么写一个基础的结构化搜索模板
打开 Search → Search Structurally…（快捷键 Ctrl+Shift+Alt+Home / Cmd+Shift+Alt+Home），在弹出框里输入类似这样的模板：
$user->getName()
注意：这不是字符串匹配，而是 AST 模式。PHPStorm 会自动把 $user 解析为“变量访问”，getName 解析为“方法名”。你还可以右键变量名 → Replace Variable，把它变成可配置的占位符（如 $EXPR$）。
- 占位符命名必须以
$开头结尾，比如$VAR$、$METHOD$ - 双击占位符可设置约束：比如限定
$VAR$必须是User类型的对象 - 不加约束时，它默认匹配任意同类 AST 节点（如所有变量访问）
- 模板中换行、空格、注释会被忽略，但括号和操作符必须准确
替换模板里怎么引用搜索到的变量
替换不是写死字符串，而是复用搜索模板里的占位符。比如搜索模板是：
立即学习“PHP免费学习笔记（深入）”；
$obj$->get<code>Id</code>()
那么替换模板就写成：
$obj$->id
这里 $obj$ 是直接复用，不是重新输入。如果搜索模板用了 $VAR$，替换里也必须用完全相同的名称，大小写敏感。
- 不能在替换里写
$var$去匹配$VAR$，会报“未定义变量” - 想把方法调用转成属性访问，但属性名要小写首字母？得用脚本约束（见下一条）
- 如果替换后出现语法错误（比如漏了分号），PHPStorm 不会自动补，需人工校验上下文
遇到大小写转换或复杂逻辑时，用脚本约束
比如要把所有 getXXX() 转成 xxx（驼峰转小写），光靠占位符不够。需要在占位符约束里启用 Script constraint：
- 选中搜索模板中的
$METHOD$占位符 → 点右侧 … → 勾选 Script constraint - 填入 Groovy 表达式：
it.name.startsWith("get") && it.name.length() > 3 - 再在替换模板中用
$METHOD$.name.substring(3).toLowerCase()获取小写属性名 - 注意：Groovy 运行在 JVM 上，
it指当前 AST 节点，it.name是方法标识符文本
这类脚本容易因 AST 节点类型不对而静默失败——比如把 getName 当作字符串处理，但实际 it.name 是 PSI identifier 对象，得用 it.nameIdentifier.text 才安全。真要稳定用，建议先用 Search → Find Usages 确认目标节点类型。
