该用performance.mark而非date.now()时：需跨浏览器、微秒级精度、与fcp等timeline条目对齐；date.now()受系统时钟漂移和后台节流影响，误差达10–100ms。
什么时候该用 performance.mark 而不是 Date.now()
当你需要跨浏览器、高精度（微秒级）、且能与 Performance Timeline 其他条目（如资源加载、FCP）对齐的时间标记时，performance.mark 是唯一可靠选择。Date.now() 受系统时钟漂移、定时器节流（尤其在后台标签页）影响，误差常达 10–100ms；而 performance.mark 基于单调递增的硬件时间源，不受页面可见性或系统负载干扰。
典型误用场景：在 React useEffect 里用 Date.now() 记录“组件挂载完成”，结果在 Safari 后台标签中被降频到 1s 一帧，完全失真。
- 必须用
performance.mark的场景：首屏渲染关键节点、路由跳转耗时、接口响应后 DOM 渲染完成点 - 可不用的场景：仅需粗略计时（如调试日志打点）、不参与后续
performance.measure或PerformanceObserver分析
performance.mark 的命名规范和生命周期管理
标记名不是随便起的字符串——它会成为后续分析的索引键，且一旦创建无法删除。命名混乱会导致 performance.getEntriesByName() 查不到、或 PerformanceObserver 漏匹配。
- 命名必须全局唯一且语义明确，推荐格式：
app-${模块}-${阶段}-${状态}，例如app-search-input-focus、app-checkout-submit-start - 避免动态拼接名（如
app-item-${id}-render），否则无法聚合统计；若必须带变量，改用detail字段传参：performance.mark('app-item-render', { detail: { id } }) - 同一名称多次调用会生成多个条目，但
getEntriesByName默认只返回最后一次——如需保留全部，必须显式传{ entryType: 'mark' }并遍历
如何用 performance.measure 关联两个 mark 并上报
performance.measure 不是独立计时器，它只是在 Performance Timeline 中画一条从 A mark 到 B mark 的线段，并生成一个 measure 类型条目。这条线段能被 PerformanceObserver 捕获，也能通过 getEntriesByType('measure') 提取。
常见错误：在 A mark 后立刻调用 performance.measure，但 B mark 尚未触发，导致 measure 条目 duration 为 0 或 NaN。
- 正确做法：确保 B mark 已执行后再 measure，例如在 Promise resolve 后、或 MutationObserver 观察到目标 DOM 出现后
- 上报前建议过滤异常值：
if (entry.duration > 0 && entry.duration （排除负值、超长等待） - 示例：
performance.mark('app-login-start'); fetch('/api/login').then(() => { performance.mark('app-login-end'); performance.measure('login-duration', 'app-login-start', 'app-login-end'); });
为什么 PerformanceObserver 比轮询 getEntriesByType 更可靠
轮询（如 setInterval 调用 performance.getEntriesByType('measure')）会漏掉高频短时事件，且无法区分新旧条目——你拿到的可能是 5 秒前就存在的旧 measure。
PerformanceObserver 是事件驱动的，只要新条目写入 Performance Timeline，回调立刻触发，且自带 entryTypes 过滤和 buffered 选项回溯历史。
- 必须设置
{ entryTypes: ['measure'] }，否则监听不到 measure 条目 - 首次初始化时加
buffered: true，可捕获 observer 创建前已存在的 mark/measure - 上报前务必检查
entry.name是否符合业务命名规则，避免第三方库的 mark（如 React 的react-lazy）混入
