WebStorm 2025.2 Help

语言注入

默认情况下,IDE 会临时注入语言。 这意味着,如果您删除嵌入的元素,相应的注入也会丢失。

语言注入可让您处理与文件主语言不同的编程语言的代码片段。

WebStorm 提供全面的语言辅助功能,可用于编辑字符串和模板字面量中的 HTML、CSS、XML、JSON、RegExp 等代码片段,以及 XML 类语言中标签和属性中的代码片段。

添加语言注入

添加持久语言注入

使用语言注入注释(annotation)添加持久注入语言片段。

  • 当您注入一种语言时,WebStorm 会建议添加注解。 按下 Alt+Enter 以接受该建议。

    自动添加语言注解
  • 您还可以在目标字符串字面量前添加一个空行,并键入以下注释:

    language=<language_ID>

    注释中请使用欲注入语言的语法。语言 ID 通常具有直观含义,例如 SQL、RegExp、XML、HTML。 语言 ID 通常具有直观含义,例如 SQL、RegExp、XML、HTML。

    您也可以在设置中查看语言 ID。 按下 Ctrl+Alt+S 打开设置,然后选择 编辑器 | 语言注入。 双击某项语言的注入规则,语言 ID 会显示在 ID 字段中。

  • (可选)在注释中添加前缀或后缀。

    // language=<language_ID> prefix=<prefix> suffix=<suffix>

    只有在以下情况下才需要:

    • 字符串是不完整的 SQL 语句

    • 字符串未直接用于我们支持的调用中(例如 select /where)

编辑注入的语言片段

WebStorm 允许您在专用编辑器中编辑注入语言片段。

打开片段编辑器

  1. 将光标置于注入的代码片段中,然后按下 Alt+Enter (或使用意图操作图标 意图操作图标)。

  2. 选择 编辑 <语言 ID> 片段

    WebStorm 会打开一个专用编辑器区域,供您编辑包含注入语言的代码。 该编辑器提供完整的编码辅助功能,包括代码补全、检查、意图操作和代码风格操作。

    在专用编辑器中编辑 HTML 片段

取消注入

  • 将光标置于代码片段处,按下 Alt+Enter ,然后从列表中选择 取消注入语言或引用

    取消语言注入
  • 或者,只需删除注入注释。

禁用意图操作灯泡图标

要在编辑器中隐藏意图操作图标 意图操作图标 ,请执行以下操作:

  1. 按下 Ctrl+Alt+S 打开设置,然后选择 编辑器 | 常规 | 外观

  2. 取消选中 显示意图灯泡 复选框。

  3. 应用更改并关闭对话框。

配置自动注入规则

在 WebStorm 中,有一组预定义规则,IDE 会根据这些规则在代码的特定位置自动注入语言。

您可在设置页面 编辑器 | 语言注入 Ctrl+Alt+S 配置语言注入规则。

语言注入设置

所有预定义的注入规则都配置为 内置 范围。 换句话说,它们是全局的(因此可用于所有 WebStorm 项目中)。 自定义规则可配置为仅适用于 IDE 或某个项目。 要更改自定义注入的范围,请使用 “移动到 Project/IDE 作用域”按钮

要通过 VCS 共享自定义规则,请使用工具栏中的相应选项将其移动到 项目 范围。 这样会在目录 .idea 中创建一个新文件,名为 IntelliLang.xml ,其中包含可置于版本控制下的自定义规则。

如果您未使用 VCS,可点击工具栏上的 导出 将规则导出为 XML 文件,并在其他项目中导入以共享规则。

要配置自定义注入规则,请点击 “添加”按钮 添加新规则,或复制预定义规则并修改其设置。

最后修改日期: 2025年 9月 26日