在C#编程中，nameof表达式是一个编译期运算符，用于获取变量、类型、方法或成员的名称字符串。它不会在运行时产生任何计算开销，因为编译器会直接将其替换为对应的字面量。借助这一特性，开发者可以在日志记录、参数验证、数据绑定等场景中避免硬编码字符串，从而降低因手动拼写或重命名遗漏带来的错误风险。
nameof的基础语法与工作原理
nameof运算符的语法非常简单，只需要在nameof后面的括号中放入想要获取名称的符号。它支持局部变量、参数、类型名称、命名空间、成员（如属性、方法、字段）等。编译器在编译阶段就会将这些符号解析为对应的标识符字符串，并直接写入中间语言（IL），因此不会产生任何反射或运行时查询成本。
下面演示一个最基础的用法，我们定义一个类并输出其属性名称：
using System;
public class User
{
public string UserName { get; set; }
}
class Program
{
static void Main()
{
User user = new User();
// 使用nameof获取属性名字符串
string propName = nameof(user.UserName);
Console.WriteLine(propName); // 输出: UserName
// 也可以直接对类型使用
string typeName = nameof(User);
Console.WriteLine(typeName); // 输出: User
}
}
从上面代码可以看出，nameof(User)得到的是“User”而不是全限定名“YourNamespace.User”。如果需要对类型使用全名，应结合typeof和Reflection，或者手动拼接命名空间。nameof只负责提取你书写的那个符号本身的简短名称。
在参数校验中提升代码健壮性
最常见的实战场景是方法参数的空值校验。传统写法往往直接写字符串抛出ArgumentException，当参数名重构时，字符串不会跟着变，导致异常信息误导。使用nameof可以把参数名绑定到编译期符号，IDE重命名时自动同步。
参考下面这个工具方法，当传入对象为null时，异常中携带的参数名始终正确：
using System;
public static class Guard
{
public static void NotNull(object value, string paramName)
{
if (value == null)
throw new ArgumentNullException(paramName);
}
}
class Service
{
public void Process(string configPath)
{
// 传统硬编码方式，重构configPath时易漏改
// if (configPath == null) throw new ArgumentNullException("configPath");
// 使用nameof，重命名configPath会自动更新
if (configPath == null)
throw new ArgumentNullException(nameof(configPath));
Guard.NotNull(configPath, nameof(configPath));
}
}
这种写法不仅减少了低级错误，也让代码可读性更高。团队成员在阅读时，能明确知道异常对应的是哪一个入参。配合Roslyn分析器，若nameof内写错符号，编译期就会报错，而字符串写法要等到运行时才发现。
与反射配合减少魔法字符串
在WPF、WinForms或某些序列化框架中，经常需要通过属性名进行绑定或映射。如果直接用字符串，不仅容易拼错，而且重构属性后绑定会静默失效。nameof可以与PropertyInfo等反射API组合，在需要名称的地方保持类型安全。
以下示例展示如何通过nameof获取属性并赋值，避免直接写字符串：
using System;
using System.Reflection;
public class Product
{
public int Id { get; set; }
public string Title { get; set; }
}
class Demo
{
public void SetTitle(Product p, string value)
{
// 使用nameof获取属性名，再反射查找
PropertyInfo prop = typeof(Product).GetProperty(nameof(Product.Title));
if (prop != null && prop.CanWrite)
{
prop.SetValue(p, value);
}
}
}
虽然反射本身有性能开销，但nameof只是让“属性名”这一参数更安全。在频繁调用的热路径中，可以将nameof结果缓存为静态只读字符串，兼顾安全与效率。另外，在Expression树中也可以用nameof替代字符串路径，使LINQ查询的字段映射更可靠。
在特性与事件中的省略技巧
C# 6.0之后，nameof可以用在特性参数里，如[DebuggerDisplay]或自定义验证特性。值得一提的是，当nameof用于指代当前类的成员时，可以省略对象或类名前缀，直接写成员名，编译器会自动解析为当前上下文的符号。
下面代码展示了在特性及简化写法中的用法：
using System.Diagnostics;
public class Order
{
public int OrderId { get; set; }
// 省略前缀，直接写成员名
[DebuggerDisplay("Id = {" + nameof(OrderId) + "}")]
public void Print()
{
// 在方法内也可直接nameof局部成员
string field = nameof(OrderId);
Debug.WriteLine(field);
}
}
这种省略形式让代码更简洁，同时保留编译期检查能力。需要注意的是，nameof不能用于获取泛型类型参数的运行时名称（如T），它只能提取源码中出现的标识符。如果涉及匿名类型或动态对象，nameof并不适用，应改用其他元编程手段。
常见误区与注意事项
不少初学者以为nameof会返回带命名空间的全名，或者能穿透基类获取重写成员的原名，其实都不行。它严格按你写的符号来。如果写nameof(BaseClass.Property)，而子类重写了Property，得到的仍是“Property”这个短名，不会包含继承链信息。
下面的对照表列出了nameof与类似方式的差异：
| 方式 | 编译期检查 | 重命名安全 | 运行时成本 |
|---|---|---|---|
| 硬编码字符串 | 无 | 否 | 无 |
| nameof | 有 | 是 | 无 |
| 反射MemberInfo.Name | 无 | 视写法 | 有 |
综合来看，只要是在源码中已知符号名称的地方，优先使用nameof都是划算的。它零成本、可维护，并且能让编译器帮你盯着改名操作。在大型项目重构、公共库开发时，这一小特性往往能省下不少排查拼写错误的时间。