params参数必须是方法最后一个参数，仅支持一维数组类型，传null需判空处理，与重载共存时易引发绑定歧义。
params 参数必须是方法的最后一个参数
这是最常踩的坑：把 params 放在普通参数中间或前面，编译器直接报错 CS0227（“params 参数必须是形参列表中的最后一个”）。它不是语法糖，而是编译器强制约定。
正确写法只能是：
void Log(string prefix, params object[] args)
而不是：
void Log(params object[] args, string suffix) // ❌ 编译失败
- 哪怕你只传一个值，
params也必须收尾 - 它后面不能再跟任何其他形参（包括可选参数、
ref、out） - 如果想支持前缀+变参+后缀，得用重载或封装一层（比如用
IEnumerable+ 手动拼接）
params 只能修饰一维数组类型
不能写 params int[][]、params string[,] 或 params List —— 编译器只认 params T[] 这一种签名。
这意味着：
-
params string[]✅ 允许传"a", "b"或new string[] { "x", "y" } -
params IEnumerable❌ 不合法，会报CS1615 - 想传集合？得显式转成数组：
Log(items.ToArray())，或者改用普通参数接收IEnumerable（但那就不是params了）
调用时传 null 会引发 NullReferenceException
很多人以为 params 能自动处理 null，结果在日志、格式化等场景里一传 null 就崩。因为 params 展开后本质还是个数组，传 null 就等于传了个空引用。
例如：
void Print(params string[] values) {
Console.WriteLine(values.Length); // 如果调用 Print(null)，这里就炸了
}
- 安全做法是在方法体内判空：
if (values == null) values = Array.Empty(); - 或者用 C# 8+ 的空合并赋值：
values ??= Array.Empty(); - 别依赖调用方“记得不传 null”——尤其当方法被多个团队共用时
params 和方法重载容易引发歧义
当你有多个重载，其中一个是 params，另一个接受具体数组，编译器有时会选错。比如：
void Process(string[] data) { ... }
void Process(params string[] data) { ... } // ❌ 编译错误：重复定义
更隐蔽的是这种：
void Handle(int x, string y) { ... }
void Handle(int x, params string[] y) { ... }
调用 Handle(1, "a") 会进第二个重载，但 Handle(1, new string[] { "a" }) 也会进第二个 —— 表面一致，实际行为可能不同（比如第二个方法内部做了数组拷贝）。
- 避免为同一语义写两个重载，其中一个带
params - 如果必须重载，优先让
params版本做兜底，非params版本走明确路径 - 注意 IDE 提示：VS 或 Rider 在调用处悬停时会显示实际绑定的方法，别光看代码补全
真正麻烦的不是语法多难，而是它在边界场景下太“安静”——不报错、不警告，只在运行时某个分支里悄悄出问题。
