使用 performance.mark 进行性能分析的核心做法是：在代码的关键执行节点前后调用该方法创建标记，随后通过 performance.getentriesbyname() 获取这些标记对象并计算时间差。具体操作时，先传入唯一的字符串名称和可选的元数据对象调用 mark，执行完业务逻辑后再次调用 mark 记录结束点，最后利用两个标记对象的 detail 或 starttime 属性得出耗时。若标记名称重复，新标记会覆盖旧标记，导致之前的测量数据丢失，因此必须确保名称唯一。
如何标记关键函数执行的起止点
要测量特定函数的执行耗时，应在函数入口处设置开始标记，在出口处设置结束标记。通过对比这两个标记的时间戳，可以精确获得该段代码的运行时长。以下是一个完整的示例程序，展示了如何标记一个模拟数据处理函数的执行过程，并输出具体的毫秒数。
const { performance } = require('perf_hooks');
function processData(data) {
// 模拟一些处理逻辑
let result = 0;
for (let i = 0; i 0 && endMarks.length > 0) {
const startTime = marks[0].startTime;
const endTime = endMarks[0].startTime;
console.log(`Processing took ${endTime - startTime} ms`);
console.log('Output:', output);
}
运行上述代码将输出类似 “Processing took 0.123 ms” 的结果，同时打印出处理后的数值总和。这里的关键在于 performance.mark 本身开销极小，适合高频调用，但需注意不要在极短的代码块中频繁创建大量标记，以免产生过多的内存开销。
如何利用 mark 区分不同请求的处理链路
在处理并发请求或复杂异步流程时，单纯的时间戳对比可能不够直观，此时可以利用 performance.mark 的第二个参数 detail 来附加上下文信息。通过在标记中存储请求 ID 或用户标识，可以在后续分析时轻松区分不同链路的性能表现。下面展示如何在异步场景下标记请求的开始与结束，并通过 detail 传递额外数据。
const { performance } = require('perf_hooks');
async function handleRequest(requestId) {
// 标记请求开始，附带 request ID
performance.mark('req-start', { detail: { requestId } });
// 模拟异步操作
await new Promise(resolve => setTimeout(resolve, 100));
// 标记请求结束
performance.mark('req-end', { detail: { requestId } });
// 获取对应请求的标记
const starts = performance.getEntriesByName('req-start', 'mark');
const ends = performance.getEntriesByName('req-end', 'mark');
if (starts.length > 0 && ends.length > 0) {
const duration = ends[0].startTime - starts[0].startTime;
console.log(`Request ${requestId} completed in ${duration} ms`);
}
}
handleRequest('abc-123');
handleRequest('def-456');
该程序会分别输出两个请求的处理耗时。通过 detail 字段，开发者可以在浏览器 DevTools 的 Performance 面板或 Node.js 的分析工具中，快速筛选出特定请求的性能数据。这种方法特别适用于排查慢请求或监控特定业务线的稳定性。
当 mark 名称冲突时会发生什么
如果多次调用 performance.mark 并使用相同的名称，新的标记会直接覆盖旧的标记。这意味着之前创建的具有相同名称的标记数据将从内部存储中移除，无法再通过 getEntriesByName 获取。例如，如果在循环中未使用动态名称生成标记，只有最后一次循环的标记会被保留，导致前面的测量数据丢失。为了避免这种情况，应结合时间戳、计数器或 UUID 生成唯一的标记名称，如 mark-${Date.now()} 或 mark-${Math.random().toString(36).substr(2, 9)}。在实际开发中，建议使用命名空间前缀来避免全局污染，例如 app.user-login-start 和 app.user-login-end，这样既能保证唯一性，又能保持语义清晰。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
