Java方法重载要求方法名相同但参数列表不同，仅返回值不同会编译报错；重载解析在编译期基于静态类型和最具体匹配原则进行，与运行时类型无关。
重载方法名必须完全相同，但参数列表不能只是返回值不同
Java 方法重载只看方法名 + 参数类型/数量/顺序，和返回值无关。写两个 int add(int a, int b) 和 String add(int a, int b) 会编译报错：duplicate method add(int, int)。
- 允许的重载组合：比如
add(int, int)、add(double, double)、add(int, int, int)、add(String, String) - 不被识别为重载：仅改变返回类型、仅加
final或访问修饰符、仅泛型类型擦除后相同（如List<string></string>和List<integer></integer>） - 注意自动装箱/拆箱可能引发意外匹配，比如传
int可能优先匹配add(Integer)而非add(long)，取决于重载候选集
避免在重载中混用可变参数和基本类型数组
void calc(int... args) 和 void calc(int[] args) 不能共存——编译器无法区分调用时传入 new int[]{1,2} 是想走哪个，直接报错：method calc is ambiguous。
- 如果已有
calc(int[])，新增可变参数版本要改名，比如calcAll(int...) - 可变参数必须是参数列表最后一个，且只能有一个；否则编译不通过
- 调用
calc(1)会触发int...版本，而calc(new int[]{1})才走int[]版本——语义差异容易误判
重载解析发生在编译期，不会根据运行时对象类型选择
重载不是多态，不看实际对象类型，只看引用声明类型。比如 Number n = new Integer(5); print(n)，调用的是 print(Number) 还是 print(Integer)，取决于你有没有定义后者，以及 n 的**静态类型**是不是 Integer。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 若只有
print(Object)和print(Number)，那么print(n)一定选Number版本（更具体） - 若还定义了
print(Integer)，而变量声明是Number n = ...，依然不会选它——因为编译器只看到Number类型 - 这点常被误以为是“重载支持动态分派”，其实它和
override完全不同机制
当参数涉及继承关系时，优先选择最具体的匹配
Java 编译器按“最具体”原则选重载方法：如果传 String，有 foo(Object)、foo(CharSequence)、foo(String) 三个版本，它一定选 foo(String)。
立即学习“Java免费学习笔记（深入）”；
- 但如果只有
foo(String)和foo(StringBuffer)，传StringBuilder会编译失败——两者无继承关系，无法匹配 - 注意
null字面量：调用foo(null)时，如果有多个引用类型重载，编译器无法判断具体该选谁，报错：reference to foo is ambiguous - 解决
null问题要么显式转型，如foo((String)null)，要么避免对null重载
