高阶函数剥离埋点的核心是用包装器自动注入日志、耗时统计与上报逻辑，业务函数零修改；支持同步/异步、动态配置、环境隔离及装饰器协同，确保异常不丢失、上报不遗漏。
用高阶函数剥离埋点，核心就一句话：让业务函数“原样执行”，把日志、上报、耗时统计这些事，塞进它调用前后的缝隙里，不碰业务代码一行。
用高阶函数包裹业务逻辑，自动附加埋点
写一个接收函数、返回新函数的包装器，业务函数本身完全不动。新函数在执行前后插入统一逻辑：
- 调用前记录开始时间、快照关键参数（只取类型+长度，避免深拷贝）
- 调用后捕获返回值或异常，计算耗时，组装事件对象
- 最后把完整上下文交给可配置的 reporter 函数上报，而不是硬编码 console.log 或 fetch
支持动态配置与环境隔离
高阶函数天然适合传入配置，比如服务名、采样率、是否启用：
- 可以这样用：
const trackedSearch = withTrace({ service: 'search', sampleRate: 0.05 })(doSearch) - 不同模块用不同配置，互不影响；测试环境可传
{ enabled: false }直接跳过埋点 - 配置不写死在函数体内，便于单元测试 mock reporter，也方便灰度开关控制
适配异步与错误传播
业务函数可能是同步的，也可能是 Promise 或 async 函数。高阶函数需分类处理：
- 对同步函数：用 try/catch 捕获异常，finally 确保上报执行
- 对 Promise 函数：用 .then/.catch 链式接管，或 await 后统一处理结果与异常
- 关键原则：不能吞异常，不能丢上报——即使业务出错，也要把失败事件发出去
与装饰器协同，覆盖类方法场景
函数组件可用高阶函数，class 组件则常配合装饰器。二者底层逻辑一致：
- 装饰器本质是语法糖，展开后仍是高阶函数：@trace(...) 等价于
fn = trace(...)(fn) - 装饰器内 wrapper 的实现，就是上面说的“包裹+捕获+上报”逻辑
- 统一使用 contextvars 或显式传参提取 trace_id，避免闭包污染或线程混淆
