命名参数必须显式写出参数名并用冒号分隔，所有命名参数须位于位置参数之后；可选参数默认值为编译期常量且仅能出现在参数列表末尾；命名与可选组合调用可跳过中间参数，但默认值固化、重载解析和位置约束易引发隐蔽问题。
命名参数调用时必须显式写出参数名
命名参数不是“自动推断”的语法糖，而是强制你用 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 层面仍是普通方法调用
命名 + 可选组合调用：跳过中间参数最常用
当一个方法有多个可选参数，而你只想指定后面的某一个时，命名参数几乎是唯一干净的写法。比如：
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 状态栏或悬停提示，确认最终绑定的是哪个方法签名
命名参数和可选参数的组合看似简单，但默认值固化、重载解析规则、参数位置约束这三点最容易在迭代开发中悄悄出问题。特别是团队协作时，有人改了默认值却忘了通知调用方重新编译。
