命名参数必须显式写出参数名并用冒号分隔,所有命名参数须位于位置参数之后;可选参数默认值为编译期常量且仅能出现在参数列表末尾;命名与可选组合调用可跳过中间参数,但默认值固化、重载解析和位置约束易引发隐蔽问题。

命名参数调用时必须显式写出参数名
命名参数不是“自动推断”的语法糖,而是强制你用 parameterName: value 的形式传参。编译器靠这个识别顺序无关性,不写冒号和名字就还是位置参数。
常见错误是混用位置和命名参数时把位置参数放在命名参数后面,比如:DoWork("a", mode: "fast", 100) —— 这会报错 CS1738: Named argument specifications must appear after all fixed arguments。
- 所有命名参数必须出现在位置参数之后
- 可选参数如果没传,必须用命名方式跳过(不能留空位)
- 命名参数名必须和方法声明中的一致,大小写敏感
可选参数必须带默认值且只能出现在参数列表末尾
C# 不允许在非末尾位置定义可选参数。例如 void Log(string level, int id = -1, string msg) 是非法的,因为 msg 没默认值却在有默认值的 id 后面。
可选参数的默认值必须是编译期常量(null、数字、字符串字面量、const 字段等),不能是运行时表达式,比如 DateTime.Now 或 new List 都不行。
- 默认值在编译时“固化”进调用方代码,不是运行时查方法定义
- 如果更新了方法的默认值但没重新编译调用方,它仍用旧默认值
- 可选参数本质是编译器生成多个重载的语法糖,IL 层面仍是普通方法调用
命名 + 可选组合调用:跳过中间参数最常用
当一个方法有多个可选参数,而你只想指定后面的某一个时,命名参数几乎是唯一干净的写法。比如:
在WINDOWS下,编译时的路径是WINDOWS安装目录。 ; 在命令行模式下,PHP.INI的查找路径可以用 -C 参数替代。 ; 该文件的语法非常简单。空白字符和用分号´;´开始的行被简单地忽略(就象你可能 ; 猜到的一样)。 章节标题(例如 : [FOO])也被简单地忽略,即使将来它们可能 ; 有某种的意义。 ; ;
void SendEmail(string to, string subject = "", string body = "", bool isHtml = false, int timeoutMs = 30000)
想只设 timeoutMs 为 60000,其他用默认值,就得写:SendEmail("a@b.com", timeoutMs: 60000)。不写命名的话,你得填满前面所有可选参数的位置,非常易错。
- 混合使用时,位置参数仍按声明顺序绑定前几个参数
- 命名参数可以重复使用同一个参数名(编译器会报错),但不能对同一参数既用位置又用命名
- XML 文档注释里的
名称要和实际参数名一致,否则 IDE 提示可能错乱
和方法重载共存时,命名参数可能改变解析结果
如果有两个重载:Do(int x, string y = "a") 和 Do(string x, int y = 1),那么调用 Do(x: "test") 会被解析为第二个重载(因为 x 是 string 类型),即使第一个重载的 y 也有默认值。
这种情况下,命名参数反而暴露了重载歧义,编译器不再靠“最少隐式转换”来选,而是优先匹配参数名 + 类型。
- 参数名相同但类型不同,容易触发意外重载选择
- 加命名后本该报错的模糊调用,可能因匹配到某个重载而静默通过
- 调试时注意看 VS 状态栏或悬停提示,确认最终绑定的是哪个方法签名
命名参数和可选参数的组合看似简单,但默认值固化、重载解析规则、参数位置约束这三点最容易在迭代开发中悄悄出问题。特别是团队协作时,有人改了默认值却忘了通知调用方重新编译。









