Java 中的可变参数

学习目标

理解 Java 可变参数的基本概念与语法
掌握如何定义和调用接受任意数量参数的方法
了解可变参数的内部实现机制及使用限制
能够在实际开发中合理运用可变参数提高代码简洁性

什么是可变参数？

可变参数（Variable Arguments，简称 Varargs） 是 Java 5 引入的一项特性，允许方法接收零个或多个同类型参数，而无需重载多个方法或手动传递数组。使用可变参数后，你可以用一个方法处理不同数量的输入，极大简化了代码结构。

返回类型 方法名(类型... 参数名) {
    // 方法体
}

其中 ...（三个点）是可变参数的标志。编译器会将这些参数自动封装成一个数组。

例如：void print(int... nums) 中的 nums 实际上是一个 int[] 数组。

示例 1

基本用法 —— 打印任意数量的名字

public class NamePrinter {
    // 接收任意数量的字符串参数
    public static void printNames(String... names) {
        for (String name : names) {
            System.out.print(name + " ");
        }
        System.out.println();
    }

    public static void main(String[] args) {
        printNames("张三", "李四");               // 2 个参数
        printNames("王五", "赵六", "钱七");       // 3 个参数
        printNames();                            // 0 个参数（合法！）
    }
}

输出：

张三 李四 
王五 赵六 钱七

即使不传任何参数，程序也不会报错，names 将是一个长度为 0 的空数组。

示例 2

处理整数并统计数量

public class NumberProcessor {
    public static void processNumbers(int... numbers) {
        System.out.println("参数个数: " + numbers.length);
        for (int num : numbers) {
            System.out.print(num + " ");
        }
        System.out.println();
    }

    public static void main(String[] args) {
        processNumbers(100);           // 1 个
        processNumbers(1, 2, 3, 4);    // 4 个
        processNumbers();              // 0 个
    }
}

输出：

参数个数: 1
100 
参数个数: 4
1 2 3 4 
参数个数: 0

注意：numbers.length 可安全获取参数数量，即使为 0 也不会出错。

可变参数内部机制

尽管语法上使用 ...，但 可变参数在底层就是数组。

例如：

void log(String... messages)

等价于：

void log(String[] messages)

JVM 在调用时自动将参数打包成数组，因此你可以在方法内像操作普通数组一样使用索引、遍历等操作。

混合使用：固定参数 + 可变参数

可变参数 可以与其他普通参数共存，但必须满足以下规则：

可变参数必须是参数列表中的最后一个参数

正确示例

public class MixedArgs {
    public static void describe(String title, int... scores) {
        System.out.println("标题: " + title);
        System.out.println("成绩数量: " + scores.length);
        for (int score : scores) {
            System.out.print(score + " ");
        }
        System.out.println("\n---");
    }

    public static void main(String[] args) {
        describe("数学考试", 95, 87, 92);
        describe("英语测验", 88);
        describe("空成绩", ); // 仅传标题，scores 为空数组
    }
}

输出：

标题: 数学考试
成绩数量: 3
95 87 92 
---
标题: 英语测验
成绩数量: 1
88 
---
标题: 空成绩
成绩数量: 0

---

错误示例（编译失败）

// ❌ 错误：可变参数 不在最后
void badMethod(int... nums, String name) { }

// ❌ 错误：多个 可变参数
void alsoBad(String... tags, int... ids) { }

这两种写法都会导致 编译错误，因为 Java 无法确定参数如何分配。

为什么需要可变参数？

在 Java 5 之前，处理可变数量参数有两大痛点：

方法	缺点
方法重载	需为每种参数数量写一个方法，代码冗余
手动传数组	调用方需先构造数组，使用不便且易错

对比：传统方式 vs 可变参数

传统方式（繁琐）：

void print(String s1) { ... }
void print(String s1, String s2) { ... }
void print(String s1, String s2, String s3) { ... }
// ...

可变参数（简洁）：

void print(String... strings) { ... } // 一个方法搞定所有情况

可变参数极大提升了 API 设计的灵活性和开发者体验。

常见应用场景

日志记录

logger.info("用户 {} 执行了操作 {}", userId, action);

工具方法

Arrays.asList("A", "B", "C"); // 底层使用 可变参数

格式化输出

String.format("Hello %s, you have %d messages", name, count);

测试框架

assertArrayEquals(expected, actual); // 支持任意长度数组比较

重点总结

可变参数使用 类型... 参数名 语法，本质是数组
方法中可安全使用 .length 和 for-each 循环
只能有一个可变参数参数，且必须放在参数列表末尾
支持零参数调用，此时数组长度为 0
显著减少方法重载，提升代码可读性与维护性

思考题

以下方法声明是否合法？为什么？
```
void method(Object... objs, String prefix)
```
如果你有一个方法 sum(int... numbers)，如何调用它来计算 1 + 2 + 3 + 4？如果传入空参数，结果应是多少？
在设计一个通用的“批量保存”数据库接口时，你会如何利用可变参数？请写出方法签名并说明优势。

源本科技 | 码上会

学习目标

什么是可变参数？

示例 1

示例 2

可变参数内部机制

混合使用：固定参数 + 可变参数

正确示例

错误示例（编译失败）

为什么需要可变参数？

对比：传统方式 vs 可变参数

常见应用场景

重点总结

思考题