
详细介绍
一句话结论:不想装构建工具、又要用 npm 生态,esm.sh 是最省事的一条路:把任意 npm 包实时转成 ESM,浏览器里直接 `import`。它适合原型和文档站,不适合当生产主干。
这是什么
esm.sh 是一个「npm 包 → ESM 模块」的 CDN。你请求 `https://esm.sh/[email protected]`,它返回的不是原始 UMD 文件,而是一段重新打包过的 ESM 代码,依赖也一并处理成可 import 的地址。它支持锁版本、指定 target(浏览器/Deno/Node)、以及 TSX 编译,所以很多「无构建」的 demo 和在线示例都靠它跑。
实测里有个细节值得说:请求 `esm.sh/[email protected]` 返回的只有 134 字节——因为那是一个 re-export 的入口文件,真正的代码在它指向的下一层地址。这不是错误,而是它的工作方式:把包拆成小块,按需加载。
我怎么用它
- 原型页里直接 `import React from "https://esm.sh/[email protected]"`,不用打包;
- 锁死版本,否则上游发版会让你的 demo 突然跑不起来;
- 需要特定运行时加 `?target=deno` 或 `?target=es2022`;
- 生产环境把解析后的模块下载到本地或自己的 CDN,别直连;
- 国内访问不稳,正式站别把它当唯一来源。
我对它的评价是「原型阶段的作弊器」:省掉 webpack/vite 配置,五分钟就能跑起一个 React demo。但它的地址是动态解析出来的,链路上任何一层变动都可能让你的页面白屏,所以只适合原型。
上手截图

图:esm.sh 首页,黑底大字 FAST / SMART / GLOBAL,定位就是把 npm 转成可直接 import 的 ESM
优点
- 任意 npm 包实时转 ESM,无需构建;
- 依赖自动处理,不会出现「找不到 require」;
- 支持多运行时 target 与 TSX;
- 免费,适合 demo、文档、教学示例。
缺点
- 返回的是入口 stub,真实代码在下一层地址,链路更长;
- 国内访问速度不稳定;
- 动态解析意味着版本与行为不完全可控;
- 不适合承载生产首屏的关键依赖。
什么时候别用它
正式产品、需要严格版本锁定与离线可用的项目、对首屏时间敏感的商业站点,都该走本地构建 + 自托管。
网友评论