IntelliJ IDEA 在调用第三方库 JAR 中的接口方法时，常无法显示原始参数名（如 name, type），仅显示占位符（如 s, i），而默认方法却能正常显示——根本原因在于 Java 字节码规范对 abstract 接口方法不强制保留参数名信息，即使编译时加了 -parameters 也无效。
intellij idea 在调用第三方库 jar 中的接口方法时，常无法显示原始参数名（如 `name`, `type`），仅显示占位符（如 `s`, `i`），而默认方法却能正常显示——根本原因在于 java 字节码规范对 `abstract` 接口方法不强制保留参数名信息，即使编译时加了 `-parameters` 也无效。
在 Java 中，接口的抽象方法（abstract）在字节码层面默认不存储参数名信息，这是 JVM 规范决定的：MethodParameters 属性（由 -parameters 编译选项生成）仅对类（class）中的方法生效，对接口（interface）中的 abstract 方法无效。这一点可通过 javap -verbose 验证：
javap -verbose Foo.class
输出中可见：
- 默认方法 getBar(String name) 的 Code 属性下包含 LocalVariableTable，其中明确记录了 name 参数；
- 抽象方法 getBar(String name, int type) 仅有方法签名 (Ljava/lang/String;I)LBar;，无 LocalVariableTable 条目，也无 MethodParameters 属性，因此反编译器（包括 IntelliJ 内置引擎）只能生成合成参数名（如 s, i）。
⚠️ 注意：-parameters 编译选项对 interface 中的 abstract 方法完全不起作用。该选项仅影响 class 文件中 MethodParameters 属性的生成，而 JVM 规范（JVMS §4.7.24）明确指出：MethodParameters 是可选属性，且接口的抽象方法通常不携带此属性——即使强制添加（如通过字节码工具），多数 JVM 实现与 IDE 也不解析它。
✅ 可行的解决方案（按推荐优先级排序）
1. 附带源码 JAR（最可靠、零副作用）
尽管提问者提到“源码不可用”，但这是唯一能 100% 恢复原始参数名的方式。若为自研或可控依赖，发布时务必提供 *-sources.jar 并正确关联至 IntelliJ：
- 在 Project Structure → Libraries 中选中对应 JAR；
- 点击右侧 “+” → “Attach Sources…” → 选择 xxx-sources.jar；
- 重启索引后，补全将立即显示 getBar(String name, int type)。
✅ 优势：无需修改编译配置、无字节码膨胀、兼容所有 JDK 版本；
❌ 前提：你拥有或能获取该库的源码包。
2. 使用 Javadoc + 自定义参数注释（间接方案）
当源码不可得时，可结合 Javadoc 提升可读性：
/**
* 获取 Bar 实例。
* @param name 资源名称（非空）
* @param type 类型标识符（见 {@link TypeEnum}）
*/
Bar getBar(String name, int type);IntelliJ 在补全时虽仍显示 s, i，但悬停提示（Ctrl+Q）会完整呈现 @param 注释，显著提升语义理解效率。
3. 升级至 JDK 17+ 并验证 --enable-preview（不推荐，仅作说明）
Java 17 引入了 JEP 416: Reimplement Core Reflection with Method Handles，但仍未改变接口抽象方法缺失参数名的字节码事实。所谓“改进”仅限反射 API 的健壮性，不影响 IDE 补全逻辑。因此不建议为此升级或启用预览特性。
? 总结
| 场景 | 是否能显示原始参数名 | 原因 |
|---|---|---|
| 接口 abstract 方法（无源码） | ❌ 否（显示 s, i 等） | 字节码无 MethodParameters / LocalVariableTable |
| 接口 default 方法 | ✅ 是 | 具备完整 Code 属性，含 LocalVariableTable |
| 类（class）中任意方法 | ✅ 是（需 -parameters） | JVM 规范支持且 IDE 已适配 |
结论：这不是 IntelliJ 的 Bug，而是 Java 字节码设计的固有限制。 若无法提供源码 JAR，请优先完善 Javadoc，并在团队内推动构建流程标准化——对外发布的接口 JAR 必须配套 *-sources.jar，这是保障下游开发体验的最小成本实践。
