在线示例与轻量前端
通过模块 URL 和 import maps 组织依赖,适合交互示例、教学页面和不想先搭建完整打包流程的小型应用。
固定包版本和依赖映射,并确认浏览器所需 API;Node.js 内置模块并不会因此在浏览器中可用。esm.sh ·
将 npm、JSR、GitHub 与 pkg.pr.new 模块转换为浏览器和 Deno 可通过 URL 导入的 ES 模块,提供公共 CDN 与 MIT 开源自托管服务器。
esm.sh 由开发者 Je Xia(@ije)创建并维护,开源仓库始于 2020 年。它希望让开发者直接通过 URL 使用 JavaScript 包,减少安装依赖和本地构建的准备工作,主要面向浏览器与 Deno 中的原生 ES 模块开发。
项目代码以 MIT 许可证开放,当前归于 esm-dev 组织。使用者既可调用公共 esm.sh 服务,也可在自己的基础设施中部署服务器,按应用需要管理构建与缓存。
公共 CDN 通过 Cloudflare 网络分发模块,支持从 npm、JSR、GitHub 和 pkg.pr.new 获取包或源文件,并提供依赖版本、构建目标及转换选项。它的核心价值在于把包解析、模块转换和分发连接起来,适合在线示例、轻量页面、交互工具和采用 import maps 的项目。
esm.sh 通过 GitHub Sponsors 和 Open Collective 接受项目赞助,Open Collective 页面由 Open Source Collective 提供财政托管。问题反馈以 GitHub Issues 为主要入口;需要私有 npm 仓库、独立访问控制或自有运行环境的团队可选择自托管,并承担相应的运维工作。
导入地址可指定包版本、子路径、依赖版本、别名和构建目标。默认构建会处理内部模块与依赖;需要减少重复依赖时,可配合 import map 与 external 选项。standalone 将外部依赖合入单文件,但不包含 peerDependencies;按导出裁剪的 exports 参数不适用于 CommonJS。raw 模式可直接取得未经模块转换的源文件。
esm.sh/tsx 可处理页面中的 JSX、TS 和 TSX 脚本,适合交互示例、教学页面和轻量原型。非 localhost 页面会将脚本源码发送至服务端编译并缓存;本机开发使用浏览器侧转换器,因此需要按源码敏感性选择接入方式,并配置匹配的 JSX 运行时。
浏览器需要支持原生 ES 模块;Deno 可使用类型声明响应头与相应运行时兼容处理。当前项目说明不将 Node.js 和 Bun 列为受支持客户端,浏览器中的 Node 兼容垫片也不等同于完整的文件系统或网络运行时。依赖原生扩展、特定 Node API 或特殊打包行为的软件包,应先在目标环境验证。
首次请求可能触发构建,大包可能超时。上线时应固定包和关键依赖版本、目标及构建选项,并保留可回退的已验证资源。当前缓存清理机制可使精确版本重新构建;旧构建版本前缀及 pin 参数也不再提供原有的构建锁定语义。要求字节稳定或离线可用的项目,可将依赖纳入自己的构建、归档或自托管流程。
公共 esm.sh 不支持私有 npm 包。需要私有仓库、访问控制或自定缓存与存储时,可部署 MIT 开源服务器,通过配置文件接入 npm 凭据、按作用域选择仓库,并使用文件系统或 S3 兼容存储。官方提供源码和 Docker 部署说明,服务器、存储、边缘缓存及维护由部署方管理。
自托管需持续更新服务器、Deno 运行时与宿主机,并隔离私有 npm 仓库和存储凭据。上线前应结合项目安全公告复核包名、路径与加载器处理;公共 CDN 的依赖也应纳入版本审查与完整性管理。
通过模块 URL 和 import maps 组织依赖,适合交互示例、教学页面和不想先搭建完整打包流程的小型应用。
固定包版本和依赖映射,并确认浏览器所需 API;Node.js 内置模块并不会因此在浏览器中可用。为采用 URL 导入的现有 Deno 应用提供包转换与类型声明入口。
构建前核对依赖锁文件;对必须重复构建的项目,考虑归档依赖或使用运行时原生的 npm 导入方式。自托管服务器可连接私有 npm 仓库,并自行管理存储、域名与访问权限。
自行负责版本更新、凭据隔离、容量规划与监控;项目安全公告也是升级评估的一部分。esm.sh 主要分发 JavaScript 包与模块,不是面向任意源站的整站加速或视频交付服务。当前文档面向浏览器与 Deno,Node.js 和 Bun 不是受支持的直接使用环境。
按业务用途了解产品:做什么、如何使用,以及是否需要单独计费。
将 npm、JSR、GitHub 与 pkg.pr.new 来源转换为可按 URL 导入的 ES 模块,提供按需构建与缓存、版本及依赖选择、import map、TSX 和 raw 文件模式。面向支持 ES 模块的浏览器与 Deno;公共服务不接入私有 npm 包。
以源码或官方 Docker 镜像部署模块构建服务器,可配置私有与按作用域划分的 npm 仓库、访问凭据、构建并发及文件系统或 S3 兼容存储。采用 MIT 许可,部署方承担主机、缓存、更新与安全维护。
通过 URL 导入公开 JavaScript 模块的浏览器与 Deno 项目
免费公共服务
需要私有 npm 仓库、独立域名与自行控制服务环境的团队
自托管
公共 CDN 可直接使用,没有单独的限时试用方案或公开的付费 SLA。
GitHub Sponsors 与 Open Collective 接受自愿赞助,并提供网站署名等回馈。 自托管需自行准备并支付服务器、存储、带宽与域名。
依赖转换和公共分发能减少准备工作;严格要求构建可重复性或独立服务保障的应用,需要安排依赖归档、自有构建或自托管。
精确版本 URL 仍应配合依赖锁定与归档策略,不能单凭包版本号假定构建字节永远不变。关键业务需评估远程构建、边缘缓存与依赖兼容性,并自行安排服务保障;自托管还需持续更新版本和隔离私有仓库凭据。
了解 esm.sh 的产品、使用场景与选型建议