环境要求

本文档介绍了使用本框架所需的环境要求,包括 Node.js 环境和浏览器兼容性。

Node.js 环境

要求 Node.js 版本 >= 24,以支持类型导入与运行时能力,减少额外编译步骤。

浏览器兼容性

兼容性策略分为两种模式:

  • 兼容模式:通过 es-module-shims 提供对动态导入与 import.meta 的向后兼容。
  • 原生 Import Maps 模式:依赖浏览器原生 Import Maps 能力。

兼容模式(默认)

浏览器最低版本
Chrome>= 64
Edge>= 79
Firefox>= 67
Safari>= 11.1

数据来源:Can I Use(Dynamic Import 与 import.meta),检索日期:2025-11。

原生 Import Maps 模式

浏览器最低版本
Chrome>= 89
Edge>= 89
Firefox>= 108
Safari>= 16.4

数据来源:Can I Use(Import Maps),检索日期:2025-11。

启用兼容支持

注意

要支持旧版浏览器,请在项目中添加 es-module-shims

<script async src="https://ga.jspm.io/npm:es-module-shims@2.0.10/dist/es-module-shims.js"></script>
建议
  • 生产环境将脚本部署到自有服务器。
  • 根据目标用户的浏览器分布决定是否启用兼容模式。