IntelliJ Java编辑器无法显示Lib Jar中接口方法参数名求助

问题描述 #

有如下接口定义：

public interface Foo {
    public Bar getBar(String name, int type);

    public default Bar getBar(String name) {
         return getBar(name, 1);
    }
}

在IntelliJ的Java编辑器中调用该接口方法时，输入foo.后出现异常：

• 抽象方法getBar(String name, int type)的参数名被显示为s、i，无法展示原定义的name、type
• 默认方法的参数名显示正常

已尝试以下操作但均未解决问题：

• 为Lib Jar附加Javadoc目录
• 使用-parameters选项编译（通过javap确认类文件已包含参数信息）

优先寻求通过附加Javadoc解决的方案，避免-parameters带来的类文件体积增大及潜在性能开销。

基于Javadoc的解决步骤 #

1. 确保Javadoc包含完整的参数标签 #

Javadoc必须为抽象方法明确添加@param标签，且标签内的参数名要与接口定义完全一致，示例正确的Javadoc格式如下：

/**
 * 获取Bar实例
 * @param name 名称参数描述
 * @param type 类型参数描述
 * @return 返回的Bar实例
 */
public Bar getBar(String name, int type);

如果原Javadoc缺失这些标签，需要补充后重新生成Javadoc Jar，再附加到目标Lib Jar上。

2. 正确关联Javadoc与Lib Jar #

在IntelliJ中按以下步骤操作：

• 打开Project Structure（快捷键Ctrl+Alt+Shift+S）
• 切换到Libraries选项卡，选中目标Lib Jar
• 在右侧Documentation标签页，点击+按钮添加Javadoc的Jar包或本地目录
• 确认Javadoc路径正确，且与Lib Jar的版本完全匹配

3. 清除缓存并重启IntelliJ #

• 点击顶部菜单File -> Invalidate Caches...
• 选择Invalidate and Restart，让IntelliJ重新加载Javadoc和类文件信息

备选方案（若Javadoc方案无效） #

• 通过实现类临时查看参数名：创建该接口的实现类，按Ctrl+O选择要实现的抽象方法，IntelliJ会根据Javadoc信息填充正确的参数名，可参考该参数名进行调用。
• 手动添加参数名注释：在调用方法时，通过注释标注参数名，示例：

  foo.getBar(/*name=*/"demo", /*type=*/1);
  

  IntelliJ会识别这类注释并在方法提示中显示参数名。

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