如何在IntelliJ中为指定包import语句添加自定义警告/错误？

关于Search Templates不支持import语句的问题 #

Search Templates功能确实无法直接匹配import语句，原因是它的底层基于PSI（程序结构接口），主要针对类、方法、变量这类代码成员级元素做结构匹配，而import属于文件级的顶层元素，当前版本的模板系统没有适配这种层级的匹配逻辑，所以输入import语句会触发"Unexpected Token"错误。

替代实现方法 #

方法1：用Structural Search Inspection自定义检查 #

这是最直接的替代方案，和Search Templates同属一套PSI匹配体系，但专门用于检查场景，支持文件级元素：

• 打开File → Settings → Editor → Inspections（Windows/Linux）或IntelliJ IDEA → Settings → Editor → Inspections（Mac）
• 点击界面左上角的+按钮，选择Add Custom Inspection
• 在弹出的窗口中选General → Structural Search Inspection，点击OK
• 在新的检查配置页中，点击Edit Template按钮，输入你要禁止的import模式：
  • 禁止单个类：import com.example.forbidden.ForbiddenClass;
  • 禁止整个包：import com.example.forbidden.*;
• 点击Check按钮验证模板合法性（这里不会再报Unexpected Token）
• 返回检查配置页，设置Severity为你需要的级别（Warning/Error），并给检查命名（比如"Forbidden Import"）
• 点击OK保存，回到Inspections列表，确保这个自定义检查处于启用状态，应用设置即可。之后项目中出现匹配的import时，就会触发对应的警告/错误。

方法2：利用现有Import检查规则扩展 #

如果只是禁止未使用的特定包，可以直接修改现有检查：

• 在Inspections的Java → Import Statements分类下，找到Unused import
• 点击Options，在Ignore imports from packages的反选逻辑里，添加你要禁止的包（注：此方法仅针对未使用的import，若要禁止已使用的import，优先用方法1）

方法3：通过External Annotations标记禁止包 #

如果是第三方包，可以给它添加外部注解标记为禁止：

• 下载目标包的源代码或生成外部注解文件
• 给包添加@Deprecated或自定义的警告注解（比如@Forbidden）
• 在Inspections中开启Java → Deprecation and restrictions → Deprecated API usage，并设置对应的严重级别，这样导入该包时就会触发警告。

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