Java方法重载匹配按四步优先级：1.精确匹配；2.基本类型向上转型（如byte→int→long）；3.装箱/拆箱；4.varargs兜底；byte/short/char互不转换，char不转short，boolean不参与数值转型，转型单向不可逆。
Java 方法重载时，如果实参类型没有完全匹配的重载方法，编译器会按固定顺序尝试自动转型来寻找最合适的候选方法。这个过程发生在编译期，不依赖运行时对象类型，只看实参表达式的静态类型和预设的转换优先级。
匹配优先级严格分四步
编译器不会“权衡”或“猜测”，而是逐级尝试，一旦某一级找到可匹配的方法就立即选定，不再往下走：
-
精确匹配：实参类型与参数类型完全一致（如传
int调用void m(int)） -
基本类型向上转型（widening）：按唯一路径自动提升，例如
byte → short → int → long → float → double，或char → int → long → float → double -
装箱/拆箱：如
int→Integer，或Integer→int - 可变参数（varargs）：最后兜底，仅当前三步都失败时才考虑
基本类型向上转型的具体路径要记牢
这不是“谁继承谁”的关系，而是 Java 规定的数值精度层级。关键点：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
-
byte、short、char三者互不转换，各自只能先升为int -
char不会转成short或byte，哪怕数值范围允许 -
boolean不参与任何数值转型，不能转成任何其他基本类型 - 转型是单向且不可逆的，比如
int可以转long，但long不能反向转int（那叫强制转换，需显式写(int)）
常见易错场景举例
理解这些例子能避免编译错误或意外交叉调用：
立即学习“Java免费学习笔记（深入）”；
- 有
void f(int)和void f(long)，调用f(5)→ 选int版本（精确匹配），不会因为long更“宽”就跳过去 - 删掉
f(int)后再调f(5)→ 自动提升为long，调用f(long) - 有
void g(char)和void g(int)，调g('a')→ 优先char（精确匹配）；注释掉g(char)后，'a'直接升为int，调g(int)，不是g(Character) - 传
null给多个引用类型重载（如void h(String)和void h(Integer)）→ 编译报错，因为两者都可通过“空引用”匹配，无明确优先级
实际编码建议
为减少歧义和提升可维护性：
- 避免同时定义参数为
int和long的重载方法，尤其当业务逻辑差异不大时 - 若需支持多种数值类型，考虑统一用包装类（如
Number）或泛型，而非靠转型猜意图 - 对
char或小整数敏感的接口，显式声明char或short参数，并配好对应重载，不要依赖它自动升为int - 单元测试中覆盖边界值（如
127、32767、65535），验证转型行为是否符合预期
