callerargumentexpressionattribute 捕获调用时传入的原始表达式文本而非参数名或值，仅在编译期生效，必须用于带默认值的 string 类型可选参数，且属性中指定的名称须与调用处形参名严格匹配。
CallerArgumentExpressionAttribute 不是用来“获取参数名”的，它捕获的是**调用时传入的原始表达式文本**——不是变量名，不是值，是那一段写在括号里的代码字面量。
它只在编译期生效，运行时不可修改或覆盖，且必须配合可选参数 + 显式默认值使用。用错地方或理解偏差，轻则失效，重则抛出编译错误。
为什么 CallerArgumentExpression("x") 有时返回空字符串？
这是最常踩的坑：你写了属性，但没给参数设默认值，或者参数类型/位置不匹配。
-
CallerArgumentExpressionAttribute只能修饰 可选参数，即必须带= null、= ""或其他合法默认值 - 参数类型必须是
string（或可为空引用类型如string?），不能是object、var或自定义类 - 属性里写的字符串（如
"x"）必须严格匹配调用时传入的形参名，大小写敏感，且不能是表达式的一部分（比如不能写"x.ToString()"） - 如果调用方用了命名参数（如
Function(value: 42)），而你标注的是[CallerArgumentExpression("value")] string expr，依然能捕获到"42"；但如果写成[CallerArgumentExpression("nonexistent")] string expr，编译器不会报错，但 expr 会回退为默认值（如""）
CallerArgumentExpression 在参数校验中的典型用法
它真正发力的地方是让 ArgumentNullException、ArgumentException 这类异常自带“上下文快照”，省去手写参数名字符串。
例如这个验证方法：
public static void NotNull<t>(T? value, [CallerArgumentExpression("value")] string? expression = null) where T : class
{
if (value == null)
throw new ArgumentNullException(paramName: expression ?? nameof(value), message: $"Value cannot be null: {expression}");
}</t>
调用时：
-
NotNull(user, nameof(user))→ 手动传参，expression被覆盖为"user" -
NotNull(GetUserFromDb())→ 自动捕获为"GetUserFromDb()" -
NotNull(config?.Settings?.Timeout)→ 捕获为"config?.Settings?.Timeout" -
NotNull((int?)null)→ 捕获为"(int?)null"，而非"null"
注意：paramName 传给 ArgumentNullException 的是表达式本身，这会让调试器和日志直接显示“哪一行代码传了 null”，而不是笼统的 "value"。
和 nameof()、CallerMemberName 的关键区别
三者常被混用，但语义完全不同：
-
nameof(x)→ 编译期取变量/成员的标识符名称，结果永远是"x"，哪怕你传的是foo.Bar.Length -
[CallerMemberName] string name→ 填入调用该方法的方法名，比如"SaveUser" -
[CallerArgumentExpression("x")] string expr→ 填入调用时写在x位置上的完整表达式文本，可能是"user"、"users[0]"、"ParseId(request.Query["id"])"
它们不能互相替代。比如你想在日志里写 “Validate failed for users[i].Name == null”，只有 CallerArgumentExpression 能做到；nameof 只能给你 "Name"，CallerMemberName 给你 "Validate"。
容易被忽略的限制与性能事实
这不是一个运行时反射机制，所有工作都在编译阶段完成：
- 表达式内容被当作字符串字面量写进 IL，不产生任何运行时开销
- 无法捕获表达式求值结果（比如
DateTime.Now.ToString()的结果是字符串，但CallerArgumentExpression捕获的只是"DateTime.Now.ToString()"这段代码） - 不支持跨项目隐式传递：如果 A.dll 定义了一个带该特性的方法，B.dll 调用它，B.dll 的编译器负责生成表达式文本，A.dll 的实现看不到“原始意图”
- 调试器中看到的
expr值是编译器填进去的常量，修改局部变量无效，也不能用条件断点去“改变”它
真正难处理的，是那些嵌套深、含泛型推导或复杂 LINQ 链式调用的场景——编译器能捕获，但生成的字符串可能极长，且不易读。这时候得靠约定（比如只对顶层参数用）或封装一层语义明确的包装方法。
