C# Stopwatch 高精度计时指南：原理、方法与性能测试实战

Stopwatch 基础与核心用法

在 C# 项目中需要精确测量代码块执行时间时，应使用 System.Diagnostics.Stopwatch 类。它比基于 DateTime 的计时方式具有更高的分辨率和精度，因为 DateTime 受系统时钟更新频率限制，而 Stopwatch 可以直接访问硬件级别的性能计数器。

第1步：创建并启动计时器

可以通过实例化对象并调用 Start() 方法开始计时，或者直接使用静态工厂方法 Stopwatch.StartNew() 一次性完成初始化和启动。这对于快速编写测试代码更为便捷。

// 方式一：分别初始化与启动
Stopwatch sw = new Stopwatch();
sw.Start();
for (int i = 0; i < 100; i++)
{
    Console.WriteLine(i);
}
sw.Stop(); // 停止计时

// 方式二：一步到位初始化并启动
Stopwatch swFast = Stopwatch.StartNew();
// ... 执行待测代码 ...
swFast.Stop();
Console.WriteLine($"用时：{sw.ElapsedMilliseconds} ms");

第2步：读取时间与重置操作

计时结束后，可以读取多种格式的运行时间数据：

• ElapsedMilliseconds：返回总耗时（long类型，单位毫秒）。
• Elapsed：返回一个 TimeSpan 对象，包含小时、分钟、秒、毫秒等详细信息。
• ElapsedTicks：返回计时器的刻度数，精度最高但需结合 Frequency 换算为具体时间。

如果需要清空当前计时结果并重新开始，可使用 Reset()；若要在保持状态的同时从当前时间点重新计时，可使用 Restart()。

sw.Reset(); // 将运行时间重置为0
Console.WriteLine($"重置后用时：{sw.ElapsedMilliseconds}");

sw.Restart(); // 停止并立即重启
// ... 新的耗时记录 ...
sw.Stop();
Console.WriteLine($"重启后总用时：{sw.ElapsedMilliseconds}");

高精度计时原理与属性解析

Stopwatch 的计时精度取决于硬件操作系统是否支持高分辨率性能计数器（High-Resolution Performance Counter）。如果支持，它将使用该计数器进行测量，否则降级使用系统定时器。

检查计时器模式

通过 Stopwatch.IsHighResolution 属性可以判断当前是否使用了高精度硬件计数器。通常在生产环境或高性能计算场景下，该值为 true。

同时，Stopwatch.Frequency 属性表示每秒钟的计数周期数。通过这个值可以将刻度假设转化为纳秒：

public static void DisplayTimerProperties()
{
    if (Stopwatch.IsHighResolution)
        Console.WriteLine("操作使用系统高分辨率性能计数器计时");
    else
        Console.WriteLine("操作使用DateTime类计时");

    long frequency = Stopwatch.Frequency;
    Console.WriteLine($"计时器频率 (每秒滴答数): {frequency}");
    
    // 计算每个刻度代表的纳秒数
    long nanosecPerTick = (1000L * 1000L * 1000L) / frequency;
    Console.WriteLine($"计时器分辨率为 {nanosecPerTick} 纳秒/滴答");
}

格式化输出耗时

为了在日志中更清晰地显示耗时过程，可以将经过的时间格式化为字符串：

Stopwatch stopWatch = new Stopwatch();
stopWatch.Start();
Thread.Sleep(5000); // 模拟耗时操作
stopWatch.Stop();

TimeSpan ts = stopWatch.Elapsed;
string elapsedTime = String.Format("{0:00}:{1:00}:{2:00}.{3:000}-{4:000}",
    ts.Hours, ts.Minutes, ts.Seconds, ts.Milliseconds,
    (ts.Ticks * 100 / 1000)%1000);
Console.WriteLine("RunTime " + elapsedTime);
Console.WriteLine("总毫秒数: " + stopWatch.ElapsedMilliseconds);

代码性能基准测试实战范例

在实际开发中，经常需要对比不同实现方式的性能。以下示例演示了如何使用 Stopwatch 对 Int32.Parse 和 Int32.TryParse 两种整数转换方式进行多次迭代测试，并统计最快、最慢及平均耗时。

此测试循环 10000 次，第一次迭代结果被丢弃以避免 JIT 编译带来的偏差。最终输出每种操作的统计信息，单位为纳秒。

private static void TimeOperations()
{
    // 计算单刻度对应的纳秒数
    long nanosecPerTick = (1000L * 1000L * 1000L) / Stopwatch.Frequency;
    const long numIterations = 10000;

    string[] operationNames = {
        "操作: Int32.Parse(\"0\")",
        "操作: Int32.TryParse(\"0\")",
        "操作: Int32.Parse(\"a\")",
        "操作: Int32.TryParse(\"a\")"
    };

    Console.WriteLine("注：1ticks=100ns，1s=1000ms");

    for (int operation = 0; operation <= 3; operation++)
    {
        long numTicks = 0, maxTicks = 0, minTicks = Int64.MaxValue;
        int indexFastest = -1, indexSlowest = -1;

        Stopwatch time10kOperations = Stopwatch.StartNew();

        for (int i = 0; i <= numIterations; i++)
        {
            long ticksThisTime = 0;
            int inputNum;

            switch (operation)
            {
                case 0:
                    try { inputNum = Int32.Parse("0"); }
                    catch { inputNum = 0; }
                    break;
                case 1:
                    Int32.TryParse("0", out inputNum);
                    break;
                case 2:
                    try { inputNum = Int32.Parse("a"); }
                    catch { inputNum = 0; }
                    break;
                case 3:
                    Int32.TryParse("a", out inputNum);
                    break;
            }

            // 此处省略了部分中间逻辑以保持简洁，实际测试需包含详细的 Tick 收集与异常处理逻辑。
            // 在真实场景中，确保每次操作前后都正确启停独立的 Stopwatch 实例以消除额外开销。
        }
        
        time10kOperations.Stop();
        Console.WriteLine($"{operationNames[operation]} 统计:");
        Console.WriteLine($"最快时间: {minTicks} ticks");
        Console.WriteLine($"平均时间: {(numTicks / numIterations)} ticks");
    }
}

总结

正确使用 C# Stopwatch 可以有效捕捉程序运行中的微小延迟，通过 Elapsed 属性和 Frequency 换算，能够深入分析代码性能瓶颈。以上就是 C# Stopwatch 高精度计时的详细内容，更多关于 C# 性能优化的资料请关注本站其它相关文章！