在C#开发中，经常需要在方法内部记录当前方法名，比如写日志或者实现属性变更通知。早期做法多依赖反射，但反射有性能损耗且写法繁琐。C# 5.0引入的CallerMemberName特性，让编译器自动填充调用方成员名称，是一种更优解。
CallerMemberName特性是什么
CallerMemberName是System.Runtime.CompilerServices命名空间下的一个属性特性。它可以应用在方法的可选参数上，当调用该方法且调用方未显式传值时，编译器会在编译阶段把调用成员（方法、属性、事件等）的名字作为实参注入。这样做的好处是无需任何运行时反射，名称和源码保持一致，重命名时也由编译器自动同步。
该特性只能用于带有默认值的参数，并且参数类型必须是字符串。如果调用方主动传入了字符串，则以传入值为准，编译器不再自动注入。它常与CallerFilePath、CallerLineNumber配合，用来定位代码位置，但在单纯获取方法名场景下，CallerMemberName已经足够。
基础用法示例
下面展示一个最简洁的写法：定义一个带CallerMemberName参数的日志方法，在业务方法里直接调用而不传方法名。
using System;
using System.Runtime.CompilerServices;
class Logger
{
public static void Log(string message, [CallerMemberName] string memberName = null)
{
Console.WriteLine($"[{memberName}] {message}");
}
}
class Demo
{
public void DoWork()
{
Logger.Log("开始执行任务");
// 输出：[DoWork] 开始执行任务
}
}
在上面的代码中，DoWork方法调用Log时并没有提供memberName参数，编译器自动把"DoWork"填了进去。如果将来把DoWork改名为Process，输出也会自动变成Process，不会出现硬编码遗漏。
需要注意的是，CallerMemberName获取的是直接调用者的成员名。如果是属性，拿到的是属性名；如果是事件，则是事件名。它不会返回包含类名的全路径，若需类名还需配合nameof或者typeof。
与反射方式对比
传统反射获取当前方法名常用MethodBase.GetCurrentMethod().Name。下面是一段等价代码：
using System;
using System.Diagnostics;
class ReflectionDemo
{
public void Run()
{
string name = new StackTrace().GetFrame(0).GetMethod().Name;
// 或者 MethodBase.GetCurrentMethod().Name
Console.WriteLine(name);
}
}
反射方案在运行时才计算方法信息，涉及栈遍历，性能明显低于编译期注入。而且在Release编译或代码混淆后，方法名可能被改写，日志可读性变差。CallerMemberName在编译后就固定为源码中的标识符，稳定且高效。
不过反射能拿到更完整的信息，比如参数列表、返回类型、所属类，而CallerMemberName只给成员名。因此简单记录调用点名称时用特性，复杂诊断再用反射或StackTrace。
在INotifyPropertyChanged中的应用
实现属性变更通知时，CallerMemberName可省去每个属性重复写字符串的麻烦。
using System;
using System.ComponentModel;
using System.Runtime.CompilerServices;
class Person : INotifyPropertyChanged
{
private string name;
public string Name
{
get { return name; }
set
{
name = value;
OnPropertyChanged();
}
}
public event PropertyChangedEventHandler PropertyChanged;
private void OnPropertyChanged([CallerMemberName] string propName = null)
{
PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propName));
}
}
上面代码中，Name属性setter调用OnPropertyChanged时不传参，编译器自动把"Name"传入，触发界面绑定的更新。如果改了属性名，通知字符串也会跟着变，避免手误导致绑定失效。
这种写法比早期用字符串字面量或lambda表达式提取属性名都更直观，也是WPF、MAUI等XAML框架中推荐的基础模式。结合Fody等织入工具还能进一步省略显式调用，但在不使用第三方库时，CallerMemberName是最轻量的原生方案。
使用限制与注意点
CallerMemberName只能注入直接调用者的成员名，无法跨越异步状态机或某些编译器生成的方法边界。例如在async方法中，若通过局部函数调用日志方法，拿到的是局部函数名而非外层异步方法名。此外它不支持获取泛型方法的泛型参数信息。
如果项目需要兼容C# 5.0之前的编译器，则无法使用该特性，只能退回反射。但在现行.NET生态中，CallerMemberName已是标准能力，可放心用于新代码，提升可读性与维护性。
C#CallerMemberName反射获取方法名修改时间：2026-08-07 07:00:24