命名参数在C#中是解决重载歧义和提升可读性的必需工具，而非语法糖；调用含多个同类型可选参数的方法时（如File.Copy），必须用命名参数明确意图，否则编译器无法解析重载。
命名参数在 C# 中什么时候必须用
命名参数不是语法糖的装饰品，而是解决重载歧义和可读性危机的实际工具。当你调用一个含多个同类型可选参数的方法时，不靠命名参数根本没法安全传值。
比如 File.Copy 有重载：Copy(string source, string dest, bool overwrite) 和 Copy(string source, string dest, bool overwrite, bool continueOnErrors)。如果只写 Copy("a.txt", "b.txt", true)，编译器无法判断你意图调用的是三参数版还是四参数版（后者第三个参数也是 bool）——这时必须显式命名：Copy("a.txt", "b.txt", overwrite: true) 或 Copy("a.txt", "b.txt", overwrite: true, continueOnErrors: false)。
- 编译器在重载解析阶段就依赖参数名做签名匹配，命名参数参与绑定，不是运行时行为
- 一旦用了命名参数，后续所有参数都必须命名（除非前面全是位置参数）
- 命名参数可以打乱顺序，但不能跳过必需参数（未提供值的非可选参数仍会报错）
命名参数与默认值的协作机制
命名参数本身不提供默认值，它只是“指路牌”；真正起作用的是方法定义里的 = 默认值表达式。两者配合才能实现跳过中间参数的效果。
看这个方法：void Log(string msg, LogLevel level = LogLevel.Info, bool includeTime = true, int maxLen = -1)。你想只指定 maxLen，其他用默认值，就必须写：Log("hello", maxLen: 100)。这里 level 和 includeTime 不是被“忽略”，而是由编译器自动补上定义时的默认值。
- 默认值必须是编译时常量（
const、字面量、enum成员等），不能是new object()或方法调用 - 命名参数传入的值会完全覆盖默认值，哪怕值相同（例如默认是
true，你写flag: true，仍是显式传入） - IL 层面，命名参数不生成额外指令，只是编译器把实参按形参声明顺序重新排列后，再以位置方式传入
命名参数对反射和动态调用的影响
反射中使用命名参数要格外小心：`MethodInfo.Invoke` 不支持命名参数，它只认位置。你传一个 new object[] { "x", level: LogLevel.Warn } 是非法的——C# 的命名语法只在编译期有效，运行时不存在 level: 这种结构。
真正能用命名参数的动态场景只有 dynamic 绑定（通过 DLR）或表达式树（Expression.Call 配合 Expression.Parameter 指定名称）。但绝大多数业务代码不会走到这一步。
-
CallSiteBinder在解析dynamic调用时，会把命名信息转为参数索引映射，再委托给目标方法 - 如果你用
Activator.CreateInstance带命名参数，会直接抛ArgumentException：“Named arguments are not supported” - 序列化/反序列化库（如 System.Text.Json）里的
[JsonPropertyName]是另一套机制，和方法参数命名无关
性能与 IL 级别的真相
命名参数零运行时开销。编译器在生成 IL 时，已经把所有命名参数还原成标准的位置调用指令（call 或 callvirt），参数数组就是按声明顺序排好的。
反编译一个用了命名参数的调用，你找不到任何 “named argument” 相关的元数据或指令。它不像 Python 的 **kwargs，也不像 JavaScript 的 rest 参数，纯粹是编译期的语法重组。
- 唯一可能的间接成本：如果方法有大量可选参数，且你总用命名跳着传，IDE 的参数提示可能变慢（因为要计算所有可能的命名组合）
- 泛型方法使用命名参数时，类型推导不受影响，但命名不能用于类型参数（
MyMethod<t>(value: 42)</t>合法，MyMethod<int>(value: 42)</int>才合法，MyMethod<t>(...)</t>是语法错误） - 别试图在 AOT 编译（如 .NET Native 或 iOS）里找命名参数的痕迹——它早被抹掉了
最易被忽略的一点：命名参数的名称必须严格匹配方法定义中的形参标识符，大小写敏感，且不支持别名或映射。写成 fileName: "x" 而方法定义是 string filename，编译直接失败——连 IntelliSense 都不会提示你“是不是少了个 d”。
