C# 中的调用方信息特性如何辅助调试？

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

在 C# 中，调用方信息特性（Caller Info Attributes）能自动获取调用方法的相关上下文信息，无需手动传参。这在调试和日志记录中非常有用，能快速定位问题发生的位置。

常用调用方信息特性

以下三个特性最常用于辅助调试：

[CallerMemberName]：自动获取调用方法的名称 [CallerFilePath]：获取源文件的完整路径 [CallerLineNumber]：获取调用所在的行号

简化日志输出

在写日志时，通常需要知道是哪个方法、哪一行代码输出的信息。使用调用方信息后，这些信息可自动生成。

void Log(string message,
    [CallerMemberName] string memberName = "",
    [CallerFilePath] string filePath = "",
    [CallerLineNumber] int lineNumber = 0)
{
    Console.WriteLine($"[{filePath}:{lineNumber}] {memberName} - {message}");
}
<p>// 调用时无需传入位置信息
Log("发生了一个警告"); 
// 输出示例：[C:\Project\Program.cs:25] Main - 发生了一个警告</p>

提升异常追踪效率

当封装自定义异常或验证逻辑时，加入调用位置信息有助于快速排查错误源头。

例如，在参数校验中：

void ValidateAge(int age,
    [CallerMemberName] string methodName = "",
    [CallerLineNumber] int line = 0)
{
    if (age < 0)
        throw new ArgumentException(
            $"无效年龄 {age}，来自方法 {methodName} 第 {line} 行");
}

一旦抛出异常，消息中已包含具体位置，节省调试时间。