语言与引用注入

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

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

除了语言注入之外，IDE 还支持引用注入，它将字符串字面量视为对其他实体的引用，例如类或文件。

添加语言注入

添加临时语言注入

将插入符置于您要注入语言的字符串字面量、标签或属性内，然后按 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>
在以下情况下是必需的：
- 字符串是不完整/部分的 SQL 语句
- 该字符串未直接用于我们支持的调用之一（例如 select /where)

为语言注入添加注解

您可以使用来自 JetBrains Annotations 库的 @Language 注解，将代码元素（如成员和参数）标记为语言注入。这将为您在 IDE 中提供正确的高亮、导航和搜索功能。

例如，您可以将一个注解参数标记为引用某个 Java 方法：

            import org.intellij.lang.annotations.Language;

            // you can use @Language as a meta-annotation
            @Language("jvm-method-name")
            @interface MethodName {}

            @interface ComponentProperties {
                @MethodName String waitForMethod() default "";
            }

            class MainComponent {
                @ComponentProperties(waitForMethod = "waitForExampleComponent")
                public ExampleComponent exampleComponent;

                private void waitForExampleComponent() { }
            }
        
  

IntelliJ IDEA 会将带注解的字符串识别为方法名，并允许您对该元素使用 Rename重构以及其他功能。

编辑注入的语言片段

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

打开片段编辑器

将插入符置于注入的代码片段内，然后按 Alt+Enter （或使用意图操作图标）。
选择编辑 <language ID> 片段。
IntelliJ IDEA 将打开一个专用编辑器区域，用于编辑注入语言的代码。此编辑器提供完整的编码辅助功能，包括代码补全、检查、意图操作s 和代码风格操作。

注入引用

引用注入将字符串字面量解释为指向其他实体（例如类、方法、字段或文件）的链接。

例如，类似 com.example.MyClass 的字符串可以解析为对 Java 类的引用，而 resources/config.json 可以视为对文件的引用。

添加临时引用注入

将插入符置于您要注入引用的字符串字面量内，然后按 Alt+Enter （或使用意图操作图标）。
选择注入语言或引用并选择一个选项，例如：
- 文件引用：向指定文件添加引用。
- JVM 类名：添加对指定类的引用。
- JVM 字段名称：添加对字段的引用。
- JVM 方法名：添加对方法的引用。
根据您安装的插件，可能还会提供其他引用选项。例如，您可能可以注入 HTTP 方法、标头或 URL 引用。

添加持久引用注入

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

在目标字符串字面量之前添加一个空行，并输入带有所需值的 // language= 注释。
- // language=file-reference 会向文件添加引用。
- // language=jvm-class-name 会添加对类的引用。
- // language=jvm-filed-name 会添加对字段的引用。
- // language=jvm-method-name 会添加对方法的引用。
示例：
public class FileReference { public static void main(String[] args) { // language=file-reference printFilePath("src/main/resources/config.properties"); } }
或
public class ClassReference { public static void main(String[] args) { //language=jvm-class-name String className = "java.util.ArrayList"; } }

取消注入

取消持久语言注入

要取消语言注入，请删除用于引入注入的注释（注解）。

取消临时语言注入

将插入符置于该代码片段处，然后按 Alt+Enter （或使用意图操作图标）。
选择取消注入语言或引用。

禁用意图操作灯泡图标

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

按 Ctrl+Alt+S 打开设置，然后选择编辑器 | 常规 | 外观。
清除显示意图灯泡复选框。
应用更改并关闭对话框。

配置自动注入规则

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

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

所有预定义的注入规则都配置为内置作用域。换句话说，它们是全局的（因此在所有 IntelliJ IDEA 项目中都可用）。自定义规则可以配置为适用于 IDE，或仅适用于单个项目。要更改自定义注入的作用域，请使用。

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

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

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

最后修改日期： 2025年 12月 2日