C# 中params关键字的用法 - 实现可变长度参数列表

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 参数
  • 它必须放在参数列表末尾,前面可有普通参数,但后面不能再跟其他参数
  • 不能用于 refout 参数
  • 泛型方法中可以使用,如 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 这个数组
基本上就这些。params 不复杂但容易忽略细节,用对了能让 API 更友好。