params关键字允许方法接收任意数量同类型参数,编译器自动打包为数组;必须是参数列表末尾的唯一一维数组参数,支持零个、多个值或显式数组传入,提升API易用性。

params 关键字让方法能接收任意数量的同类型参数,本质是编译器帮你把多个实参自动打包成一个数组传入。
基本用法:声明和调用
在方法参数列表中,params 必须是最后一个参数,且只能修饰一维数组类型(如 int[]、string[])。
- 声明示例:void PrintNumbers(params int[] numbers)
- 调用方式灵活:可传零个、一个、多个值,也可直接传数组
- PrintNumbers(); → numbers 为长度为 0 的空数组
- PrintNumbers(1, 2, 3); → 编译器自动生成 new int[]{1,2,3}
- PrintNumbers(new int[]{4,5}); → 显式传入数组,不会额外包装
使用限制与注意事项
params 不是万能的,有几条硬性规则必须遵守:
- 一个方法中最多只能有一个 params 参数
- 它必须放在参数列表末尾,前面可有普通参数,但后面不能再跟其他参数
- 不能用于 ref 或 out 参数
- 泛型方法中可以使用,如 T[],但需确保 T 是具体类型或由调用推断
常见实用场景
适合封装日志、格式化输出、集合初始化等需要“弹性输入”的逻辑:
- 日志记录:Log("Error", "User not found", "ID=123");
- 字符串拼接:Join(" | ", "a", "b", "c") 返回 "a | b | c"
- 简化构造:配合对象初始化,减少重载方法数量
与数组参数的区别
写 void M(int[] a) 和 void M(params int[] a) 看似一样,但调用体验不同:
- 前者必须显式传数组:M(new int[]{1,2});
- 后者支持“展开式”调用:M(1,2); 更自然、更易读
- 两者在方法体内处理完全一致,都是操作 a 这个数组










