Intellij @Language注解在依赖库中无法生效，求解决方法

问题重现 #

测试库中定义了如下方法并添加IntelliJ的@Language注解：

assertHtml(@Language("HTML") String html) {}

同一项目内或使用复合构建（includeBuild）时，调用该方法的字符串参数能正常触发HTML语法高亮；但将库打包后作为常规依赖引入主项目时，IntelliJ无法识别该注解，语法高亮失效。

解决方案 #

1. 确保测试库正确传递注解依赖

@Language注解来自com.intellij:annotations包，需保证该依赖能传递到主项目：

• Gradle项目：在库的build.gradle中使用api范围引入依赖，而非compileOnly：

  api "com.intellij:annotations:24.0.1" // 版本号匹配你的IntelliJ版本，可按需调整
  

• Maven项目：在库的pom.xml中设置依赖范围为compile：

  <dependency>
      <groupId>com.intellij</groupId>
      <artifactId>annotations</artifactId>
      <version>24.0.1</version>
      <scope>compile</scope>
  </dependency>
  

如果使用compileOnly或provided，主项目无法获取到@Language注解类，自然无法识别注解标记。

2. 验证库的编译产物保留注解

打包库后，解压jar包并反编译assertHtml方法所在的class文件，确认@Language("HTML")注解存在于字节码中。若注解缺失，需检查构建配置是否有移除注解的操作（比如混淆规则排除了注解）。

3. 刷新主项目依赖并清除IntelliJ缓存

• 执行项目构建命令刷新依赖（Gradle：./gradlew clean build；Maven：mvn clean install）
• 打开IntelliJ，依次点击File -> Invalidate Caches...，勾选"Clear file system cache and local history"后重启IDE，清除可能的缓存冲突。

4. 确认IntelliJ语言注入配置

打开Settings/Preferences -> Languages & Frameworks -> Language Injection：

• 确保"Enable language injection"选项已勾选
• 检查@Language注解的注入规则是否存在，且HTML类型的映射正确

内容的提问来源于stack exchange，提问作者Janning Vygen