PhpStorm 的结构化检索对 index.html 无效，因其不解析 HTML 为 AST，仅做字符串匹配；HTML 被视为标记语言，无语义节点支持，重构功能禁用，应改用 Find in Path + 正则并严格预览。
PhpStorm 的结构化检索（Search Structurally）对 index.html 文件本身基本无效——它不解析 HTML 为 AST，无法识别标签、属性或 DOM 关系，强行使用只会匹配纯文本，失去“结构化”意义。
为什么 Search Structurally 在 index.html 里不起作用
结构化检索是 PhpStorm 面向 PHP、Java、JS 等有强语法树（AST）的语言设计的。HTML 被 IDE 视为标记语言而非编程语言，Search Structurally 对其不构建语义节点，只做字符串层面的模糊模板匹配。比如你写模板 $tag$->$attr$，它不会理解这是「开始标签里的某个属性」，而只是找形如「任意字符→任意字符」的文本组合。
- 右下角显示
HTML类型 ≠ 支持结构化搜索——这只是格式化和高亮的基础条件 - 所有 HTML 相关的「重构」操作（重命名、提取、移动）均被禁用，灰色不可点
- 即使在
index.html中选中id="app"后按Ctrl+Shift+Alt+Home，弹出的窗口也仅支持正则/文字搜索，无 AST 节点选择器
想精准改 HTML 属性？用 Find in Path + 正则 + 预览
这才是真正可控、可复现、能防误改的方式。关键不是“结构”，而是“上下文锚定”。
- 查找
id="[^"]*"，勾选Regex和Dot matches newline，范围限定为index.html单文件 - 若目标是改所有
class值中含btn-的部分，用class="([^"]*btn-[^"]*)"，替换为class="$1-modern" - 务必先点
Preview：检查是否误命中data-class="btn-primary"或注释里的<!-- btn-default --> - 避免全局替换
href=".*?"——它会连href="mailto:test@example.com"一起吃掉，应限定为href="(https?://|/)
需要跨 HTML/JS/PHP 联动修改？靠 Find Usages + 手动确认
比如 JS 里写了 document.getElementById("nav-toggle")，你想同步更新 index.html 中的 id="nav-toggle" 和对应 class="js-nav-toggle"：
立即学习“PHP免费学习笔记（深入）”；
- 在 JS 中把光标停在字符串
"nav-toggle"上，按Alt+F7（Find Usages） - 结果列表里若出现
index.html中的id="nav-toggle"，说明索引已建好；没出现就先File → Reload project from disk - 右键该 HTML 用法 →
Replace in Path，填新 ID，并设置File mask: *.html、Match case、Words only - 不要跳过
Preview：id="nav-toggle"和class="nav-toggle"字符完全一致，但语义不同，必须人工甄别
结构化检索不是万能钥匙，HTML 是声明式树状文档，不是执行态代码。越想用它“智能推导”，越容易在第 2 次替换时发现 <header id="main"></header> 被错改成 <header id="main" class="new"></header>——因为正则没锁死边界，而结构化检索根本没生效。
