如何用PhpStorm结构搜索替换转换Blade模板的li标签为div？

问题背景 #

在PHP Blade模板中有大量class为navi-item的<li>标签，需要转换为class为menu-item的<div>标签。普通搜索替换仅能修改开始标签，无法处理闭合标签；正则全局替换在全项目中使用存在风险。尝试使用PhpStorm的Structural Search Replace功能，设置了如下搜索和替换模板，但在存放.blade.php文件的views/目录（已设置文件类型为PHP）中搜索结果为空：

原搜索模板 #

<li class="navi-item">
    $content$
</li>

原替换模板 #

<div class="menu-item">
    $content$
</div>

解决方法 #

• 调整模板的空白匹配规则
  原模板硬编码了换行和缩进，而Blade模板中的标签格式可能不固定（比如标签与内容同行、缩进数量不同）。修改搜索模板为无固定空白的形式：

  <li class="navi-item">$content$</li>
  

  然后在结构搜索对话框中，勾选Allow whitespace differences（允许空白差异），忽略换行、空格的差异，确保匹配所有格式的标签。

• 指定正确的文件类型
  不要选择PHP作为文件类型，改为Blade（需确保PhpStorm已启用Laravel插件）。Laravel插件会专门解析Blade模板语法，让结构搜索能正确识别模板中的HTML标签，避免因PHP文件类型的语法解析规则导致匹配失败。

• 配置$content$变量的匹配范围
  默认的$content$可能仅匹配简单文本，无法处理嵌套标签或Blade指令。点击$content$变量，在右侧约束面板中：

  • 将Text/regexp设为.*
  • 勾选Multiline（多行匹配）
  • 设置Minimum count为0、Maximum count为unlimited
    这样$content$就能匹配从空内容到复杂嵌套结构的所有情况。

• 先测试单个文件再扩展范围
  先找一个明确包含目标<li class="navi-item">的单个Blade文件进行搜索测试，确认模板能正常匹配后，再扩展到整个views目录，排除批量搜索时的干扰因素。

• 确认Laravel插件状态
  打开PhpStorm的Settings -> Plugins，确保Laravel插件已启用。该插件是PhpStorm正确解析Blade模板的核心，未启用的话会导致结构搜索无法识别Blade中的HTML结构。

内容的提问来源于stack exchange，提问作者SupaMonkey