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,但注意它只取最右边的标识符:
-
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# 中提升代码健壮性和可读性的小而关键的语法糖。










