C#中的nameof运算符是编译时运算符，能够在编译阶段将变量、类型、方法、属性等程序元素的名称转换为对应的字符串，不需要在运行时通过反射获取，既保证了性能，也避免了硬编码字符串带来的维护问题。
nameof运算符的基本语法
nameof运算符的语法非常简单，直接使用nameof(目标元素)即可，目标元素可以是变量、类型、命名空间、方法、属性、事件、参数等。编译时，编译器会将nameof(目标元素)替换为对应的名称字符串，不会生成任何运行时的反射调用。
下面是几个基础的使用示例：
using System;
namespace NameofDemo
{
class Program
{
static void Main(string[] args)
{
string userName = "test";
// 获取变量名称字符串
Console.WriteLine(nameof(userName)); // 输出：userName
// 获取类型名称字符串
Console.WriteLine(nameof(Program)); // 输出：Program
// 获取命名空间名称字符串
Console.WriteLine(nameof(System.Console)); // 输出：Console
// 获取属性名称字符串
var user = new User();
Console.WriteLine(nameof(user.Name)); // 输出：Name
}
}
class User
{
public string Name { get; set; }
}
}
nameof运算符的常见使用场景
1. 参数校验时抛出准确异常
在方法参数校验场景中，使用nameof可以自动获取参数名称，当参数不符合要求抛出异常时，异常信息中的参数名会和实际参数名保持一致，重构修改参数名时不需要手动修改异常信息中的字符串。
using System;
class ParameterCheckDemo
{
public void PrintUserName(string userName)
{
if (string.IsNullOrEmpty(userName))
{
// 使用nameof获取参数名，避免硬编码
throw new ArgumentException("参数不能为空", nameof(userName));
}
Console.WriteLine(userName);
}
}
2. 实现INotifyPropertyChanged接口
在WPF、WinForms等数据绑定场景中，实现INotifyPropertyChanged接口需要传递属性名称字符串，使用nameof可以避免硬编码属性名，重构修改属性名时编译器会自动提示修改对应的nameof表达式。
using System.ComponentModel;
class UserViewModel : INotifyPropertyChanged
{
private string _name;
public string Name
{
get { return _name; }
set
{
if (_name != value)
{
_name = value;
// 使用nameof获取属性名，重构时自动同步
OnPropertyChanged(nameof(Name));
}
}
}
public event PropertyChangedEventHandler PropertyChanged;
protected virtual void OnPropertyChanged(string propertyName)
{
PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
}
}
3. 日志记录时标记元素名称
在日志记录场景中，使用nameof可以自动标记当前操作的变量、方法或类型名称，不需要手动编写字符串，减少拼写错误的概率。
using System;
class LogDemo
{
public void ProcessData()
{
try
{
// 业务逻辑
}
catch (Exception ex)
{
// 记录日志时自动获取方法名
Console.WriteLine($"方法{nameof(ProcessData)}执行失败，错误信息：{ex.Message}");
}
}
}
nameof运算符的使用注意事项
- nameof是编译时运算符，结果在编译阶段就已经确定，不会参与运行时计算，因此性能比反射获取名称高很多。
- nameof获取的是元素的简单名称，不包含命名空间、类型前缀等信息。比如
nameof(System.Console.WriteLine)的结果是WriteLine，而不是完整的方法签名。 - nameof不能用于获取局部函数的内部变量名称，只能用于可访问的程序元素名称。
- 如果目标元素是关键字，nameof返回的关键字字符串不需要额外转义，比如
nameof(@class)的结果是class。
nameof与传统硬编码的对比
下面是两种方式的多维度对比：
| 对比维度 | nameof运算符 | 硬编码字符串 |
|---|---|---|
| 重构安全性 | 重构修改元素名时编译器自动提示修改，无遗漏风险 | 需要手动查找替换所有对应字符串，容易遗漏 |
| 拼写错误风险 | 编译时检查，写错元素名直接编译报错 | 拼写错误编译不报错，运行时才会暴露问题 |
| 性能 | 编译时替换为字符串，无运行时开销 | 无额外性能开销，但维护成本高 |
| 可读性 | 直接关联元素，代码可读性高 | 字符串和元素无直接关联，可读性低 |
总结
nameof运算符是C#中非常实用的编译时特性，能够有效解决硬编码字符串带来的维护问题，在参数校验、数据绑定、日志记录等场景中都有广泛的应用。开发者在需要获取程序元素名称字符串时，应优先使用nameof运算符，提升代码的健壮性和可维护性，减少因名称变更导致的潜在bug。
C#nameof_operator字符串获取代码重构编译时检查修改时间：2026-07-20 09:18:29