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

来源:这里教程网 时间:2026-02-21 17:32:33 作者:

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# 中提升代码健壮性和可读性的小而关键的语法糖。

相关推荐

热文推荐