C#可变参数(params)从入门到精通：解决方法参数不确定性的最佳实践

1次阅读

没有评论

共计 2391 个字符，预计需要花费 6 分钟才能阅读完成。

在 C# 开发中，我们经常会遇到方法需要处理不确定数量参数的情况。比如：

日志记录方法需要接受不同数量的参数
数学计算函数可能需要处理任意数量的数值
字符串格式化工具需要灵活的参数输入

传统上，我们可能会采用以下方法来解决这个问题：

数组传参：要求调用者显式创建数组
方法重载：为不同参数数量创建多个重载方法

但这些方法都有明显缺点：

数组传参使调用代码变得冗长
方法重载会导致代码量爆炸式增长
两种方法都降低了 API 的易用性

方案	优点	缺点	适用场景
params	调用简单，语法优美	有 GC 压力	一般业务逻辑
数组传参	显式控制	调用不便	性能敏感场景
泛型集合	类型安全	需要额外转换	复杂数据处理
元组	结构清晰	参数数量有限	少量固定参数

在 IL 层面，params 本质上是在编译时自动创建数组并填充参数，没有特别的运行时支持。

// 基础用法
public static int Sum(params int[] numbers)
{return numbers.Sum();
}

// 调用方式
var result = Sum(1, 2, 3, 4, 5); // 无需显式创建数组

/// <summary>
/// 带固定参数和可变参数的方法
/// </summary>
/// <param name="format"> 格式字符串 </param>
/// <param name="args"> 格式参数 </param>
/// <returns> 格式化后的字符串 </returns>
public static string FormatLog(string format, params object[] args)
{return string.Format(format, args);
}

/// <summary>
/// 计算任意数量数值的平均值
/// </summary>
public static double Average(params double[] values)
{if (values == null || values.Length == 0)
        throw new ArgumentException("至少需要一个参数");

    return values.Average();}

/// <summary>
/// 记录带时间戳的日志
/// </summary>
public static void Log(string category, params object[] messages)
{var timestamp = DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss");
    Console.Write($"[{timestamp}] [{category}]");

    foreach (var msg in messages)
    {Console.Write(msg + " ");
    }

    Console.WriteLine();}

/// <summary>
/// SQL WHERE 条件构建器
/// </summary>
public class WhereBuilder
{private readonly List<string> _conditions = new();

    public void AddConditions(params string[] conditions)
    {_conditions.AddRange(conditions);
    }

    public string Build()
    {return _conditions.Any() 
            ? "WHERE" + string.Join("AND", _conditions)
            : string.Empty;
    }
}

虽然 params 很方便，但在高频调用场景下可能会产生 GC 压力：

GC 压力：每次调用都会创建新数组
优化方案 ：使用ArrayPool<T> 重用数组

优化示例：

public static int OptimizedSum(params int[] numbers)
{
    var sum = 0;
    foreach (var num in numbers)
    {sum += num;}
    return sum;
}

// 高频调用时改用 ArrayPool
public static int PooledSum(ReadOnlySpan<int> numbers)
{
    var sum = 0;
    foreach (var num in numbers)
    {sum += num;}
    return sum;
}

不要在接口中使用 params
违反 LSP（里氏替换原则）
实现类无法改变参数数量

正确的 null 检查方式

// 错误方式
public void BadMethod(params string[] values)
{if (values == null) // 可能漏掉空数组情况

// 正确方式
public void GoodMethod(params string[]? values)
{if (values is null || values.Length == 0)