C# 中的nameof表达式有什么用 - 获取变量、类型或成员的名称

nameof 表达式在编译期获取标识符的字符串名称,零运行时开销,支持智能感知与重命名重构;适用于异常参数、INotifyPropertyChanged、数据注解等场景,但仅支持静态标识符,不支持索引、动态表达式或运行时值。

nameof 表达式用来在编译期获取变量、参数、字段、属性、方法、类型等的**字符串名称**,不依赖反射,零运行时开销,且支持智能感知和重命名重构。

避免硬编码字符串,提升代码可维护性

写日志、异常信息或绑定表达式时,常需要写字段名或参数名。手动写字符串容易拼错,且重命名后不会自动更新。
nameof 就能让 IDE 帮你同步:

  • 错误写法:throw new ArgumentException("userName");
  • 正确写法:throw new ArgumentException(nameof(userName)); → 编译后就是 "userName",但重命名 userName 变量时,IDE 会一并更新字符串

配合异常和验证逻辑更安全

在参数校验、INotifyPropertyChanged、数据注解等场景中,nameof 是推荐做法:

  • if (value == null) throw new ArgumentNullException(nameof(value));
  • PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(Title)));
  • [Required(ErrorMessage = "字段 " + nameof(Email) + " 不能为空")] public string Email { get; set; }

支持嵌套成员和泛型类型(有限)

nameof 可以写 nameof(obj.Property)nameof(List.Count),但注意它只取最右边的标识符:

  • nameof(person.Name)"Name"(不是 "person.Name"
  • nameof(Console.WriteLine)"WriteLine"
  • nameof(List)"List"(泛型实参会被忽略)

不能用于动态或运行时值

nameof 是编译期特性,只能作用于已知的标识符:

  • ✅ 支持:nameof(MyClass)nameof(Options.Timeout)nameof(x)(x 是局部变量)
  • ❌ 不支持:nameof(arr[0])nameof(GetType().Name)nameof(someVariable ?? "default")

基本上就这些 —— 简单、轻量、实用,是 C# 中提升代码健壮性和可读性的小而关键的语法糖。