Java中可变参数本质是语法糖，编译器将其自动转为对应类型数组，声明格式为“类型...参数名”，必须位于参数列表末尾且唯一，支持不传参、传字面量、传单值、传数组四种调用方式。

Java 中可变参数（Varargs）本质是语法糖，定义简单，但使用有明确规则。它不是新类型，而是编译器自动把传入的零个或多个同类型实参打包成一个数组。

怎么定义可变参数

在方法参数列表末尾，用「类型 + 三个英文点（...）+ 参数名」格式声明：

• 写法必须是 int... nums，不能写成 int ...nums（空格错误）或 int..nums（少一个点）
• 可变参数只能有一个，且必须放在参数列表最后
• 前面可以有其他普通参数，例如：public void log(String level, int... codes)
• 错误示例：public void bad(int... nums, String s) —— 编译不通过

底层是怎么解析的

编译阶段，Java 就把可变参数转为对应类型的数组。比如 String... args 实际等价于 String[] args：

deep-java-review

Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...

下载

• 调用 method("a", "b", "c") → 编译器生成 new String[]{"a","b","c"} 并传入
• 调用 method() → 生成空数组 new String[0]
• 调用 method(arr)（arr 是 String[]）→ 直接复用该数组，不新建

常见调用方式与注意事项

可变参数支持四种合法调用，但需注意隐含行为：

立即学习“Java免费学习笔记（深入）”；

• 不传参：sum() → 方法内收到长度为 0 的数组，可安全遍历（for-each 不报错）
• 传多个字面量：sum(1, 2, 3) → 最常用，简洁直观
• 传单个值：sum(5) → 等价于 sum(new int[]{5})
• 传已有数组：sum(numsArray) → 注意：不会自动“拆包”再装包，直接传递原数组引用

⚠️ 特别提醒：如果已有数组，又想让它被当作「多个独立参数」参与重载匹配（而非走可变参数路径），需显式拆开调用，否则可能触发意料外的重载选择。