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<int>.Count)</int>,但注意它只取最右边的标识符:
nameof(person.Name)→
"Name"(不是
"person.Name")
nameof(Console.WriteLine)→
"WriteLine"
nameof(List<string>)</string>→
"List"(泛型实参会被忽略)
不能用于动态或运行时值
nameof 是编译期特性,只能作用于已知的标识符:
✅ 支持:nameof(MyClass)、
nameof(Options.Timeout)、
nameof(x)(x 是局部变量) ❌ 不支持:
nameof(arr[0])、
nameof(GetType().Name)、
nameof(someVariable ?? "default")
基本上就这些 —— 简单、轻量、实用,是 C# 中提升代码健壮性和可读性的小而关键的语法糖。
