Java自动类型转换是隐式、安全的小范围到大范围数值类型提升机制，发生在赋值、运算和方法调用中，如byte→int、int→long、int→double，支撑标准库API的重载选择与参数适配，但不适用于数组或布尔类型。
Java 自动类型转换机制在标准库 API 中不是“显式功能”，而是底层支撑许多常用 API 行为的隐性基础。它不常被单独提及，却广泛存在于方法调用、参数传递、返回值适配和集合/工具类内部逻辑中。理解它，能帮你避开编译错误、解释反直觉行为，并写出更自然、安全的代码。
自动转换如何影响 Java 标准库方法调用
很多标准库方法声明了较宽泛的参数类型（如 int、long 或 double），而你传入更小范围的字面量或变量时，编译器会自动完成转换：
-
Math.max(int a, int b)接收两个 int，但你可以直接传byte、short或char—— 它们在传参前自动提升为 int -
String.format("%d", 127L)中，long值可直接用于%d（对应 int）格式符？不行，会报错；但用于%ld或%d配合 long 参数是合法的 —— 这里体现的是类型匹配而非自动转换，真正自动转换发生在像System.out.println(100)这类重载方法选择中：编译器根据字面量类型（int）自动选中println(int)而非println(double) -
Arrays.sort(new int[]{1, 2, 3})的泛型重载版本Arrays.sort(T[])不适用基本类型，但Arrays.sort(int[])是专用重载 —— 此处无转换；真正发生自动转换的是当你调用Integer.valueOf(byteValue)时，byte会先自动转成 int，再参与Integer.valueOf(int)的调用
包装类与自动装箱背后的隐式转换
自动类型转换常与自动装箱（autoboxing）协同工作，成为标准库 API 可用性的关键一环：
-
ArrayList<integer></integer>的add(42)中，字面量42是 int，而泛型要求Integer。这里分两步：int → Integer（自动装箱），而装箱本身依赖 int 值的合法性 —— 若你写byte b = 5; list.add(b);，则先发生 byte → int（自动类型转换），再 int → Integer（自动装箱） -
Map.put("key", (short)100)传入Short对象，但如果 Map 是Map<string number></string>，Short可被接受，因为Short是Number子类 —— 这属于继承关系，不是基本类型转换；但若你调用Double.valueOf((short)100)，实际调用的是Double.valueOf(int)，short 先自动转 int，再装箱为Integer，最后通过doubleValue()转为Double
数值计算类 API 中的类型提升规则
涉及混合运算的标准库工具（如 BigDecimal 构造、Math 函数、流式计算）往往暴露自动转换的边界：
立即学习“Java免费学习笔记（深入）”；
-
BigDecimal.valueOf(10L)和BigDecimal.valueOf(10)都合法 —— 因为 int 和 long 都可作为参数传入对应重载方法；但BigDecimal.valueOf(10.5f)实际调用的是valueOf(double)，因为 float 会自动提升为 double（精度可能变化） -
IntStream.range(1, 10).mapToLong(i -> i * 2L).sum()中，i是 int，2L是 long，乘法表达式结果自动提升为 long，符合mapToLong的函数签名 -
Math.pow(2, 3)两个 int 参数，但方法签名是pow(double, double)—— 编译器自动将两个 int 提升为 double 后调用，这是最典型的自动转换应用
容易踩坑的 API 边界场景
自动转换看似省事，但在标准库中容易引发隐性问题：
-
Files.write(path, "hello".getBytes(), StandardOpenOption.CREATE)中，"hello".getBytes()返回 byte[]，而Files.write期望 byte[] —— 没问题；但若误写成Files.write(path, new short[]{1,2})，编译失败：没有write(Path, short[])重载，且 short[] 无法自动转为 byte[]（数组类型不兼容，自动转换只适用于基本类型间） -
Thread.sleep(1000)参数是 long 毫秒，但传int字面量1000完全合法 —— 因为 int → long 是安全自动转换；但若传System.currentTimeMillis()（返回 long）给需要 int 的旧 API（如某些 Swing 方法），就必须强制转换，且可能溢出 -
Optional.of(5)接收 Object，所以int会先装箱为Integer；但OptionalInt.of(5)是专门针对 int 的优化类型 —— 这里没有自动转换，而是 API 设计刻意规避装箱开销
不复杂但容易忽略
