本文介绍如何在 Node.js 中精准测量函数或代码段的执行耗时，重点推荐使用内置的 perf_hooks 模块替代 console.time()，兼顾精度、可编程性和生产友好性。
本文介绍如何在 node.js 中精准测量函数或代码段的执行耗时，重点推荐使用内置的 `perf_hooks` 模块替代 `console.time()`，兼顾精度、可编程性和生产友好性。
在 Node.js 开发中，快速评估函数性能是日常调试与优化的关键环节。虽然 console.time() / console.timeEnd() 简单易用，但它属于非标准 API，精度有限（通常为毫秒级，且受事件循环干扰），不适用于高精度场景，也不便于自动化分析或集成到监控体系中。
更专业、更可靠的方式是使用 Node.js 内置的 perf_hooks 模块——它基于系统高精度计时器（如 process.hrtime.bigint()），提供纳秒级分辨率，且设计符合 Web Performance API 规范，语义清晰、扩展性强。
✅ 推荐方案：使用 perf_hooks.performance
以下是一个完整、可直接运行的示例，测量 extract() 函数的精确执行时间：
import { performance } from 'node:perf_hooks';
const a = /* your input data */;
function extract(input) {
// 模拟实际业务逻辑（例如解析、转换、计算等）
return input?.toString()?.toUpperCase()?.repeat(1000) || '';
}
// ⏱️ 开始计时标记
performance.mark('extract-start');
const ext = extract(a);
// ⏹️ 结束计时标记
performance.mark('extract-end');
// ? 创建性能度量：从 start 到 end 的耗时
const measure = performance.measure(
'extract-duration', // 度量名称（可用于后续统计）
'extract-start', // 起始标记名
'extract-end' // 结束标记名
);
console.log(`✅ 执行完成，耗时：${measure.duration.toFixed(3)} ms`);
// 输出示例：✅ 执行完成，耗时：0.127 ms
? 提示：measure.duration 单位为毫秒（ms），但底层精度可达微秒甚至纳秒，toFixed(3) 可确保输出可读性。
? 进阶用法与注意事项
- 避免标记名冲突：建议为每次测量使用唯一标记名（如加入时间戳或 UUID），尤其在循环或异步调用中；
-
异步函数测量：对 async 函数，需在 await 前后分别打标：
performance.mark('async-start'); await someAsyncOperation(); performance.mark('async-end'); performance.measure('async-op', 'async-start', 'async-end'); - 清理资源（可选）：大量重复测量时，可调用 performance.clearMarks() 或 performance.clearMeasures() 防止内存累积；
- 兼容性：perf_hooks 自 Node.js v8.5.0 起稳定可用，现代项目（v14+）可放心使用；
- 不推荐 --time 标志：Node.js 官方 CLI 从未提供 --time 参数；该混淆可能源于 Linux time 命令（如 time node test.js），但它测量的是整个进程生命周期（含启动开销），无法聚焦函数级耗时。
✅ 总结
| 方案 | 精度 | 可编程性 | 生产适用性 | 是否推荐 |
|---|---|---|---|---|
| console.time() | 毫秒级（低） | 弱（仅打印） | ❌ 不建议用于监控/CI | ⚠️ 仅限临时调试 |
| Date.now() / process.hrtime() | 高（需手动计算） | 中（易出错） | ⚠️ 底层但繁琐 | △ 可用，但不推荐 |
| perf_hooks.performance | 纳秒级（高） | ✅ 强（API 丰富、支持标记/度量/监听） | ✅ 官方推荐、零依赖 | ✅ 首选方案 |
将性能测量作为开发习惯的一部分，不仅能快速定位瓶颈，也为后续 APM 集成和性能基线建设打下坚实基础。
