WebStorm 2025.1 Help

语言注入

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

WebStorm 提供全面的语言支持,用于编辑 HTML、CSS、XML、JSON、RegExp 以及字符串和模板字面量中的其他代码片段,以及 XML 类语言中的标签和属性。

开始之前

确保在 IntelliLang 页面的 已安装 选项卡中启用了 设置 | 插件 捆绑插件,如 安装插件 中所述。

临时注入一种语言

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

  1. 将光标放在您希望注入语言的字符串或模板字面量、标签或属性中,然后按 Alt+Enter (或使用意图操作图标 意图操作图标)。

  2. 选择 注入语言或引用 并选择您想要注入的语言。

    注入 HTML

使用语言注入注释

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

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

    language=<language_ID>

对于注释,请使用您想要插入的语言的语法。 语言 ID 通常很直观,例如,SQL、RegExp、XML、HTML。

您还可以在设置中了解 language ID。 按 Ctrl+Alt+S 打开设置,然后选择 Editor | language Injections。 双击某语言的注入规则;语言 ID 已指定在 ID 字段。

语言片段可以与前缀和后缀组合在一起,作为包装器,将片段转换为语法完整的语言单元。 编辑代码时,您只能在片段编辑器中看到前缀和后缀。 它们不会显示在主编辑器中。

前缀和后缀可以包含在注入注释中,如下所示:

// language=<language_ID> prefix=<prefix> suffix=<suffix>
在语言注入中使用前缀和后缀

打开注入编辑器

  1. 将文本光标放在注入代码片段内,然后按 Alt+Enter (或使用意图操作图标 意图操作图标)。

  2. 请选择 编辑 <language ID> 片段

    WebStorm 将会打开一个专门的编辑区来编辑注入的语言代码。 此编辑器提供全面的编码辅助,包括代码自动完成、检查、意图和代码风格操作。

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

取消注入

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

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

禁用意图操作灯泡图标

请执行以下操作以隐藏编辑器中的意图操作图标 意图操作图标

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

  2. 清除 显示意图灯泡 复选框。

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

配置自动注入规则

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

您可以在 Editor | Language Injections 设置页面&#xa0; Ctrl+Alt+S 上配置语言注入规则。

语言注入设置

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

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

如果您不使用 VCS,您可以通过将规则导出到 XML 文件(点击工具栏上的 导出 )然后将其导入到另一个项目来分享您的规则。

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

为语言注入配置背景

对于 JavaScript、TypeScript、HTML、XML 和 Pug 注入,您可以为背景使用自定义颜色。

  1. 打开 设置 对话框(Ctrl+Alt+S ),转到 编辑器 | 配色方案 ,并选择您想要自定义注入背景颜色的语言。

  2. 在中央窗格的列表中,选择 注入的语言片段 ,然后在右侧窗格中选择 背景 复选框。

    如果所选语言从其他语言继承了背景颜色,则 背景 字段将被禁用。 要覆盖继承的设置,请先清除 继承值自 复选框。

    点击 背景 复选框旁边的字段,并在打开的 选择颜色 对话框中选择一种颜色。

配置语言注入的自定义背景
最后修改日期: 2025年 4月 22日