std::chrono::high_resolution_clock是C++11起唯一靠谱的高精度时间源，底层通常映射到系统单调时钟（如Linux的CLOCK_MONOTONIC），精度可达纳秒级，适用于start/stop/reset计时器设计。
StopWatch 类该用什么时间源
别用 clock() 或 time()，精度低、不可靠，尤其在多核或休眠后会跳变。C++11 起唯一靠谱的选择是 std::chrono::high_resolution_clock —— 它是标准库中精度最高、行为最可预测的时钟，底层通常映射到系统单调时钟（如 Linux 的 CLOCK_MONOTONIC）。
注意：不要假设 high_resolution_clock::is_steady 一定为 true（虽然绝大多数实现都是），实际使用中只依赖其单调性，不依赖它是否“绝对稳定”。
如何设计 start / stop / reset 接口
核心是状态管理：需要记录是否正在运行、上次启动时间、累计耗时。避免用布尔标志 + 多重 if 判断，直接用 std::optional<:chrono::time_point></:chrono::time_point> 存起始点更清晰安全。
-
start()：如果没在运行，记录当前时间点；已在运行则忽略（或抛异常，看需求） -
stop()：仅当正在运行时，把从起始点到现在的差值累加进总耗时，清空起始点 -
reset()：清空累计时间和起始点，回到初始状态 -
elapsed()返回std::chrono::nanoseconds（或double秒），别裸返回duration——调用方还得自己转换
为什么 elapsed() 要支持运行中读取
很多场景需要实时查看已过去多久，比如调试循环、监控函数执行进度。所以 elapsed() 必须能正确处理“正在运行”和“已停止”两种状态：
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 若正在运行：返回累计耗时 + 当前时间与起始点之差
- 若已停止：只返回累计耗时
- 避免在
elapsed()里做if (running) { ... }分支——逻辑分散易出错，统一用一个内联计算逻辑更可靠
示例关键片段：
auto elapsed() const {
auto total = m_elapsed;
if (m_start_time) {
total += std::chrono::high_resolution_clock::now() - *m_start_time;
}
return std::chrono::duration_cast<std::chrono::nanoseconds>(total);
}
跨平台编译要注意的头文件和链接问题
纯头文件实现即可，不需要额外链接库。但必须包含：
-
<chrono>（核心） -
<optional>（C++17 起；若需 C++14 兼容，改用bool + time_point手动管理） -
<cassert>（仅用于 debug 断言，非必需）
Windows 上 MSVC 默认支持 C++17，但若项目设为 C++14，std::optional 会报错；Clang/GCC 同理。确认编译器 flag（如 -std=c++17）已启用。没有运行时依赖，也无需 -lpthread 等链接项。
真正容易被忽略的是：某些嵌入式或老环境可能没有 high_resolution_clock 的高精度实现（比如只回退到毫秒级），这时 elapsed() 返回值的最低有效位可能始终为 0 —— 不是 bug，是硬件/OS 限制，得提前测试目标平台的实际分辨率。
