OpenTelemetry JavaScript SDK 的 ECMAScript 目标版本升级决策

OpenTelemetry JavaScript SDK 团队近期做出了一个重要技术决策：将代码编译目标从 ES2017 升级到 ES2022。这一变更涉及多个技术考量和权衡，值得深入探讨其背景、决策过程和实现方案。

背景与动机

在 JavaScript 生态系统中，ECMAScript 标准的演进带来了诸多新特性。OpenTelemetry 作为一款广泛使用的可观测性工具，需要在兼容性和现代化之间找到平衡点。

原先项目采用的是 ES2017 作为编译目标，这确保了向后兼容性，但限制了使用新语言特性的可能。随着 Node.js 生态的演进（当前最低支持版本为 Node.js 18），升级编译目标的条件已经成熟。

技术挑战与权衡

升级过程中，团队面临几个关键挑战：

1. 模块系统兼容性：如何在支持 ESM 的同时不影响现有 CJS 用户
2. 异步模块加载：处理平台特定代码的动态导入问题
3. API 兼容性：确保核心 API 包不引入破坏性变更

特别是关于顶层 await（TLA）的讨论非常关键。虽然 ES2022 支持 TLA，可以简化异步模块加载的代码结构，但会破坏 CJS 用户的兼容性。经过深入讨论，团队决定采用折中方案：升级到 ES2022 但禁用 TLA。

实现方案

最终的实施方案包含以下要点：

1. 差异化编译目标：

   • 核心 API 和语义约定包保持 ES2017 目标
   • 其余 SDK 包升级到 ES2022

2. 构建流程调整：

   • 修改构建系统以支持多目标编译
   • 通过 Lerna 或定制脚本实现分模块编译

3. 代码规范：

   • 通过 lint 规则明确禁用 TLA
   • 保持代码风格一致性

技术影响与建议

对于 OpenTelemetry 用户和贡献者，这一变更意味着：

1. 性能优化：可以使用更多现代 JavaScript 特性优化性能
2. 开发体验：贡献者可以编写更简洁现代的代码
3. 兼容性保障：通过禁用 TLA 确保 CJS 用户不受影响

对于需要支持更低版本 JavaScript 运行时的用户，建议通过构建工具链自行降级编译 SDK 代码。

这一技术决策体现了 OpenTelemetry 团队在推动技术演进与保障稳定性之间的平衡智慧，为后续的功能开发和性能优化奠定了良好基础。