C#如何使用nameof表达式 C# nameof运算符使用技巧

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

nameof 是 C# 6.0 引入的编译时运算符，它不执行任何运行时操作，只在编译期将标识符（如变量名、方法名、属性名、类型名等）转换为对应的字符串字面量。它安全、高效，且支持重构 —— 重命名时自动同步，不会出现“魔法字符串”问题。

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

传统写法容易出错：

if (value == null) throw new ArgumentNullException("valu"); // 拼错！

用 nameof 后，拼写由编译器保障：

if (value == null) throw new ArgumentNullException(nameof(value));

IDE 重命名

value

变量时，

nameof(value)

会自动更新，不会遗漏。

适用于各类成员和上下文

nameof 可作用于：

局部变量、参数：
nameof(input)
字段/属性：
nameof(User.Name)
（返回 "Name"）方法：
nameof(ToString)
、
nameof(GetUserById)
类型：
nameof(string)
→ "String"，
nameof(List<int>)</int>
→ "List`1" 命名空间或类嵌套：
nameof(MyNamespace.MyClass.MyProperty)
→ "MyProperty"（只取最后一段）

注意：不能用于表达式或字符串拼接，例如

nameof(x + y)

或

nameof("abc")

都会编译失败。

在日志、验证和反射场景中特别实用

常见模式示例：

参数验证：
Guard.Against.Null(user, nameof(user))
日志记录：
logger.LogWarning("Failed to process {PropertyName}", nameof(Config.TimeoutMs))
INotifyPropertyChanged：
OnPropertyChanged(nameof(FirstName))
（比
"FirstName"
更安全） 配置绑定提示：当配置项缺失时，提示用户检查
nameof(AppSettings.DatabaseUrl)
对应的配置键

小技巧与注意事项

几个实用细节：

支持点号访问，但只解析到最后一个标识符：
nameof(obj.Property)
和
nameof(Property)
结果相同泛型类型名带反引号和数字：
nameof(List<string>)</string>
返回 "List`1"，不是 "List" 可用于
const string
初始化：
private const string NameKey = nameof(User.Name);
（编译期确定） 不能用于动态对象、匿名类型属性、或未声明的名称 —— 编译器必须能静态识别该标识符