DataGrip 2025.3 Help

语言与引用注入

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

当您将一种语言(如 HTML、CSS、XML、RegExp 等)注入字符串字面量时,即使它不是您的项目的主要语言,您也可以获得针对注入代码的全面编码支持。

除了语言注入外,IDE 还支持引用注入,将字符串字面量视为对其他实体的引用。

添加语言注入

添加临时语言注入

  1. 将插入符置于您要注入语言的字符串字面量、标签或属性内,然后按 Alt+Enter (或使用 意图操作 图标 意图操作图标)。

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

    注入 HTML

添加持久语言注入

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

  • 在目标字符串文本前添加一个空行,并输入以下注释:

    -- 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>

    在以下情况下是必要的:

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

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

编辑已注入的语言片段

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

打开片段编辑器

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

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

    DataGrip 将会打开一个专门的编辑区来编辑注入的语言代码。 此编辑器提供完整的编码辅助功能,包括代码补全、检查、 意图操作s 和代码风格操作。

    在指定的编辑器部分打开代码片段

注入引用

引用注入将字符串字面量解释为指向其他实体(例如文件)的链接。

例如, resources/config.json 可被视为对文件的引用。

添加临时引用注入

  1. 将插入符置于您要注入引用的字符串字面量内,然后按 Alt+Enter (或使用 意图操作 图标 意图操作图标)。

  2. 选择 注入语言或引用 并选择一个选项。 例如, 文件引用 会添加指向指定文件的链接。

    根据您安装的插件,可能还会提供其他引用选项。

    注入文件引用

添加持久引用注入

使用注释添加持久引用注入。

  • 在目标字符串字面量之前添加一个空行,并输入带有所需值的 -- language= 注释。

    • -- language=file-reference 会向文件添加引用。

    示例:

    -- language=file-reference INSERT INTO config_path (id, path) VALUES (1, 'resources/config.json');

取消注入

取消持久语言注入

若要取消语言注入,请删除用于引入该注入的注释(标注)。

    取消临时语言注入

    1. 将插入符置于该代码片段处,然后按 Alt+Enter (或使用 意图操作 图标 意图操作按钮)。

    2. 请选择 取消注入语言或引用

    禁用意图操作灯泡图标

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

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

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

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

    配置自动注入规则

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

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

    语言注入设置

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

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

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

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

    最后修改日期: 2025年 12月 1日