如何让IDEA提示使用Kotlin扩展函数替代Java原方法？

问题背景 #

有一个无法修改的老旧Java库，代码如下：

public final class SomeOldJavaClass {
    private SomeOldJavaClass() { }

    public static SomeOldJavaClass wayTooLongFactoryMethod() {
        return new SomeOldJavaClass();
    }

    public String stupidlyLongNameForGetter() { return "hello"; }
}

已为其定义对应的Kotlin扩展函数：

fun SomeOldJavaClass() = SomeOldJavaClass.wayTooLongFactoryMethod()

val SomeOldJavaClass.value: String
    get() = stupidlyLongNameForGetter()

希望让IDEA给出提示或警告，建议避免使用原库方法，转而使用自定义扩展函数，类似JDK类/方法的内置提示效果。

解决方案 #

可以通过IntelliJ IDEA的自定义检查规则实现需求，具体步骤如下：

1. 创建自定义结构搜索检查 #

打开IDEA设置（File > Settings 或 Ctrl+Alt+S），进入 Editor > Inspections，点击右上角的+按钮，选择Add Structural Search Inspection。

2. 针对工厂方法配置检查 #

• 在Search template中输入原方法调用模式：

  SomeOldJavaClass.wayTooLongFactoryMethod()
  

• 设置Context为Expression，确保匹配所有调用该静态方法的场景
• 在Replace template中填入扩展函数调用：

  SomeOldJavaClass()
  

3. 针对Getter方法配置检查 #

再创建一个自定义结构搜索检查：

• 搜索模板设置为：

  $instance$.stupidlyLongNameForGetter()
  

• 点击Edit variables，将$instance$的类型指定为SomeOldJavaClass
• 替换模板设置为：

  $instance$.value
  

4. 设置提示级别与信息 #

为每个自定义检查设置警告级别（如黄色警告），并填写提示文本，例如："建议使用Kotlin扩展函数替代老旧方法"。保存设置后，IDEA会在检测到原方法调用时自动弹出提示，还支持一键替换为扩展函数。

补充：Java代码场景的提示优化 #

如果需要覆盖Java代码中的调用提示，可通过IDEA的External Annotations功能，给原库的目标方法添加@Deprecated注解（无需修改原库代码），并指定替代方案，这样Java代码中调用这些方法时也会收到废弃提示。

内容的提问来源于stack exchange，提问作者java.is.for.desktop