什么是 MethodTimer.Fody？
MethodTimer.Fody 是一个基于 AOP（面向切面编程）的 .NET 库，作为 Fody 的插件（weaver），它在编译阶段自动向方法中注入计时代码，从而在运行时方便地记录方法的执行时长，而无需手动在每个方法中添加 Stopwatch 代码。该库通过 IL（中间语言）织入方式实现几乎零运行时开销，是提升代码整洁性和性能监控效率的利器。
MethodTimer.Fody GitHub地址：https://github.com/Fody/MethodTimer
为何使用 MethodTimer.Fody 而不是传统 Stopwatch？
减少样板代码：手动在每个方法中插入 Stopwatch 逻辑既繁琐又容易错误。而 MethodTimer.Fody 只需简单标注 [Time] 就可自动注入所需逻辑。
AOP 无侵入设计：原业务逻辑无需任何改动，保持干净结构，也便于统一管理性能监控点。
编译时织入、运行效率高：相比反射或动态代理手段，AOP 编译注入方式带来的性能损耗极小，非常适合需要高频调用的场景。
快速上手：安装与基本配置
1. 安装 NuGet 包
首先确保安装了 Fody，因为 MethodTimer.Fody 依赖 Fody：
PM> Install-Package Fody
PM> Install-Package MethodTimer.Fody
注意：Install-Package Fody 不可省略，否则可能默认安装旧版本 Fody，导致兼容性问题。
2. 创建并配置 FodyWeavers.xml
在项目根目录下添加 FodyWeavers.xml 文件，内容如下：
<Weavers>
<MethodTimer/>
</Weavers>
3. 标注需要监控的方法
在希望测量执行时间的方法上添加 [Time] 属性：
public class MyClass
{
[Time]
public void MyMethod()
{
// 要监控的业务逻辑
Console.WriteLine("Hello");
}
}
4. 查看编译后效果
编译后，方法体内部会被自动注入类似以下逻辑：
var start = Stopwatch.GetTimestamp();
try { /* 原方法逻辑 */ }
finally
{
var end = Stopwatch.GetTimestamp();
var elapsed = end - start;
var elapsedTimeSpan = new TimeSpan(/* ... */);
Trace.WriteLine("MyClass.MyMethod " + elapsedTimeSpan.TotalMilliseconds + "ms");
}
这部分由 MethodTimer.Fody 自动生成，无需手动干预。
支持自定义拦截日志行为：Interceptor 用法
MethodTimer.Fody 支持将日志行为委托给自定义静态拦截器（Interceptor），以便你将计时信息集成到现有日志框架或调试输出，形式如下：
public static class MethodTimeLogger
{
// 可选两个重载，优先使用 TimeSpan 重载
public static void Log(MethodBase method, TimeSpan elapsed, string message)
{
// 使用你的日志系统记录，例如 Serilog、NLog 等
}
public static void Log(MethodBase method, long milliseconds, string message)
{
// 仅提供毫秒级别的记录方式
}
}
编译后，类似被替换为：
MethodTimeLogger.Log(methodof(MyClass.MyMethod), (long)elapsedTimeSpan.TotalMilliseconds);
这样你可以灵活地记录计时数据到控制台、文件、Application Insights 等。
在 ASP.NET Core API 中使用 MethodTimer.Fody
MethodTimer.Fody 非常适用于 ASP.NET Core 中对 API 性能进行细粒度监控的场景。以下是简要使用步骤：
在你的 Web API 项目中，安装 MethodTimer.Fody 并添加 FodyWeavers.xml。
在 Controller 中标注 [Time] 属性：
[HttpGet]
[Time]
public IEnumerable<Author> GetAuthors()
{
// 示例逻辑，为了明显看到效果可添加 Thread.Sleep
Thread.Sleep(500);
return authors;
}
运行项目并访问该接口，即可在输出里看到类似 “GetAuthors executed in 500 ms” 的日志。
该方法让你轻松监控 API 方法的性能，无需手动添加计时代码或使用外部拦截机制。
注意事项与最佳实践
调试兼容性：由于 IL 被编织，调试时可能出现断点跳转位置偏差或堆栈显示异常。建议对调试带来影响的方法减标或使用 Resharper Assembly Explorer、dnSpy 进行辅助调试。
适用范围：MethodTimer.Fody 适合快速诊断和优化性能热点，但不适合长期精准基准测试。对于微秒级精度需求，推荐使用 BenchmarkDotNet。
保持依赖最新：建议使用较新版本的 Fody 和 MethodTimer.Fody（目前最新为 3.2.3，更新于 2025-02-24）以获得最佳兼容性和功能支持。
社区反馈与实战经验
在 Stack Overflow 上，有用户分享了在测试项目中使用 MethodTimer.Fody 来记录方法执行时间的示例，并提供了自定义拦截器的写法。
来自 Reddit 的开发者表示：“With this package you can Time method or All methods in assembly. And you do not even need to modify your code.”
这体现了 MethodTimer.Fody 简洁高效、低侵入的设计理念。
总结
MethodTimer.Fody 是一款简单却功能强大的 .NET 性能计时器，通过 Fody 编译时织入机制，可以：
- 自动注入计时代码，减少手动 Stopwatch 书写。
- 灵活配置拦截器输出日志，可整合进现有日志系统。
- 在 API 性能优化、方法级监控方面尤为高效。
- 注意调试兼容性并结合正确的工具使用。
希望这篇文章能够帮你快速掌握 MethodTimer.Fody 的安装、使用与实践技巧，实现方法级性能透明化监控与优化。