GoLand 2025.2 Help

语言注入

语言注入使您能够处理嵌入在代码中的其他语言代码片段。 将一种语言(如 HTML、CSS、XML、RegExp 等)注入字符串字面量后,即使该语言不是项目的主要语言,也能获得对注入代码的全面编码支持。

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

添加语言注入

添加持久性语言注入

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

  • 在目标字符串字面量之前键入以下注释:

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

添加临时语言注入

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

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

    注入 HTML

编辑注入的语言代码片段

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

打开片段编辑器

  1. 将插入符号放在注入的代码片段内,并按 Alt+Enter (或使用意图操作图标 意图操作图标)。

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

    GoLand 将打开一个专用的编辑器区域,用于编辑包含注入语言的代码。 该编辑器提供完整的编码支持,包括代码补全、检查、意图和代码样式操作。

    在专用编辑器区域中打开代码片段

取消注入

取消持久性语言注入

如需取消语言注入,请删除用于引入注入的注释(annotation)。

    取消临时语言注入

    1. 将插入符号放置在代码片段上方,按 Alt+Enter (或使用意图操作图标 意图操作按钮)。

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

    禁用意图操作灯泡图标

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

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

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

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

    配置自动注入规则

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

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

    所有预定义的注入规则均配置为 内置 范围。 换言之,它们是全局规则(因此在所有 GoLand 项目中均可用)。 可以为 IDE 或单个项目配置自定义规则。 若要更改自定义注入的范围,请使用 “移动到项目/IDE 范围”按钮

    若要通过 VCS 共享自定义规则,请使用工具栏上的相应选项将规则移动到 项目 范围。 执行上述操作后,将在 .idea 目录中创建一个名为 IntelliLang.xml 的新文件,其中包含可进行版本控制的自定义规则。

    如果未使用 VCS,您可以通过将规则导出为 XML 文件(点击工具栏上的 导出 )再导入至另一个项目中进行共享。

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

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