# @esbuild-kit/esm-loader 中文文档 规范地址：https://npmcn.com/package/%40esbuild-kit/esm-loader/ 版本：2\.6\.5 npm 元数据更新时间：2026-07-12T11:31:18.491Z 中文译文更新时间：2026-11-13T21:51:56.412Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40esbuild-kit/esm-loader 原文对照：https://npmcn.com/package/%40esbuild-kit/esm-loader/?lang=original 项目主页：https://github.com/esbuild-kit/esm-loader#readme 源码仓库：https://github.com/esbuild-kit/esm-loader 弃用说明：Merged into tsx: https://tsx\.hirok\.io ## 关键信息（来自 npm 元数据） - 包体积（解压后）：13.4 kB，4 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - 运行依赖：2 个 - 首次发布：2022-05-10T17:30:42.956Z - 最新版本发布：2023-09-17T07:38:20.523Z - 近 30 天下载量：119629668（2026-10-14 至 2026-11-12，npm 官方下载统计） - 已发布版本数：30（近 12 个月 0 个） ## 中文简介 用于将类型Script模块编译到无害环境管理的节点.js加载器 ## 安装 ```sh npm install @esbuild-kit/esm-loader ``` 也可以使用：`pnpm add @esbuild-kit/esm-loader`、`yarn add @esbuild-kit/esm-loader`、`bun add @esbuild-kit/esm-loader` ## README # 自动装填器 [节点.js 加载器](https://nodejs.org/api/esm.html#loaders) 用于装入 TypeScript 文件. ### 特征 - 应要求将类型脚本转换为无害环境管理 - 经典节点.js 分辨率( 无扩展目录导入) - 用于提高性能的缓存 - 支持节点.js v12.20.0+ - 处理 `node:` 导入前缀 - 决定: `tsconfig.json` [`paths`](https://www.typescriptlang.org/tsconfig#paths) - 从 JSON 模块命名的导入 > **Protip: 使用时使用 _装弹机_ 或者说 _tx_** > > _自动装填器_ 仅转换ES模块(`.mjs`编号 :`.mts` 扩展或 `.js` 文件在 `module` 类型包). > > 转换普通JS文件( E)`.cjs`编号 :`.cts` 扩展或 `.js` 文件在 `commonjs` 类型软件包,使用此软件包 [_装弹机_](https://github.com/esbuild-kit/cjs-loader)。 。 。 . > > 或者,使用 [tx](https://github.com/esbuild-kit/tsx) 自动处理它们. [![Premium sponsor banner](https://privatenumber-sponsors.vercel.app/api/sponsor?tier=platinum&image)](https://privatenumber-sponsors.vercel.app/api/sponsor?tier=platinum) ## 安装 ```sh npm install --save-dev @esbuild-kit/esm-loader ``` ## 使用量 过 `@esbuild-kit/esm-loader` 输入 [`--loader`](https://nodejs.org/api/cli.html#--experimental-loadermodule) 旗帜. ```sh node --loader @esbuild-kit/esm-loader ./file.ts ``` ### 类型脚本配置 使用以下属性: `tsconfig.json` 在工作目录中: - [`strict`](https://www.typescriptlang.org/tsconfig#strict): 是否转换为严格模式 - [`jsx`](https://esbuild.github.io/api/#jsx): 是否改变JSX > **警告:** 设定为 `preserve`,JSX语法将保持不变。 为了防止Node.js扔出语法错误,将另一个能将JSX转换为JS的Node.js加载器链起来. - [`jsxFactory`](https://esbuild.github.io/api/#jsx-factory):如何改造JSX - [`jsxFragmentFactory`](https://esbuild.github.io/api/#jsx-fragment):如何改变JSX碎片 - [`jsxImportSource`](https://www.typescriptlang.org/tsconfig#jsxImportSource): 从何处导入 JSX 函数 : - [`allowJs`](https://www.typescriptlang.org/tsconfig#allowJs): 是否将 tsconfig 应用到 JS 文件 - [`paths`](https://www.typescriptlang.org/tsconfig#paths):用于解决别名 #### 自定义 `tsconfig.json` 路径 默认, `tsconfig.json` 将从当前工作目录中检测到. 要设置自定义路径,请使用 `ESBK_TSCONFIG_PATH` 环境变量 : ```sh ESBK_TSCONFIG_PATH=./path/to/tsconfig.custom.json node --loader @esbuild-kit/esm-loader ./file.ts ``` ### 缓存 模块转换在系统缓存目录中被缓存([`TMPDIR`](https://en.wikipedia.org/wiki/TMPDIR)) (中文(简体) ). 变形被内容散列所缓存,所以重复的依赖性不会被重新转换. 设置环境变量 `ESBK_DISABLE_CACHE` 至真值以禁用缓存 : ```sh ESBK_DISABLE_CACHE=1 node --loader @esbuild-kit/esm-loader ./file.ts ``` [![Premium sponsor banner](https://privatenumber-sponsors.vercel.app/api/sponsor?tier=gold&image)](https://privatenumber-sponsors.vercel.app/api/sponsor?tier=gold) ## 财务问题 ### 它能导入 JSON 模块吗 ? 对 这个加载器转接了JSON模块,因此它也与命名的导入兼容. ### 它能否通过网络导入无害环境管理模块? Node.js 已内置支持网络导入 [后边 `--experimental-network-imports` 旗帜](https://nodejs.org/api/esm.html#network-based-loading-is-not-enabled-by-default)。 。 。 . 你可以通过它 `esm-loader`数字 : ```sh node --loader @esbuild-kit/esm-loader --experimental-network-imports ./file.ts ``` ### 它能在没有扩展名的情况下解决文件吗 ? 在无害环境管理中,进口路径必须是明确的(必须包括文件名称和扩展名). 对于后向相容性,此加载器会为扩展添加经典节点分辨率的支持: `.js`, (中文(简体) ), `.json`, (中文(简体) ), `.ts`, (中文(简体) ), `.tsx`, (中文(简体) ), `.jsx`解决 `index` 按目录名称编写的文件也起作用. ```js import file from './file' // -> ./file.js import directory from './directory' // -> ./directory/index.js ``` ### 它能使用Node.js的CommonJS解析算法吗? 无害环境管理进口解决方案预计有明确的进口路径,而通用JS解决方案预计有隐含进口(如无扩展和目录进口). 由于这一变化,Node.js改变了它如何导入一个既匹配文件又匹配目录的路径. 在无害环境管理中,目录将被导入,但在CJS中,文件将被导入. 要用于通用JS分辨率算法,请使用 [`--experimental-specifier-resolution=node`](https://nodejs.org/api/cli.html#--experimental-specifier-resolutionmode) 旗帜. ```sh node --loader @esbuild-kit/esm-loader --experimental-specifier-resolution=node ./file.ts ``` ## 相关 - [tx](https://github.com/esbuild-kit/tsx) - 节点.js 运行时间供电,使用 [`@esbuild-kit/cjs-loader`](https://github.com/esbuild-kit/cjs-loader) 财务报告和审定财务报表 [`@esbuild-kit/esm-loader`](https://github.com/esbuild-kit/esm-loader)。 。 。 . - [@ esbuilt- kit/ cjs- loader (英语)](https://github.com/esbuild-kit/cjs-loader) - TypeScript & MESM 使用Node.js加载器API到CJS转接器. ## 发起人 [![Premium sponsor banner](https://privatenumber-sponsors.vercel.app/api/sponsor?tier=silver1&image)](https://privatenumber-sponsors.vercel.app/api/sponsor?tier=silver1)[![Premium sponsor banner](https://privatenumber-sponsors.vercel.app/api/sponsor?tier=silver2&image)](https://privatenumber-sponsors.vercel.app/api/sponsor?tier=silver2) [![](https://cdn.jsdelivr.net/gh/privatenumber/sponsors/sponsorkit/sponsors.svg)](https://github.com/sponsors/privatenumber) ## 常见问题 ### @esbuild-kit/esm-loader 是什么？ 用于将类型Script模块编译到无害环境管理的节点\.js加载器注意：该包已被作者标记为弃用——Merged into tsx: https://tsx\.hirok\.io ### 如何安装 @esbuild-kit/esm-loader？ 在项目目录运行 npm install @esbuild-kit/esm-loader，或使用 pnpm add / yarn add / bun add。 ### @esbuild-kit/esm-loader 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/esbuild-kit\_\_esm-loader 是否存在。 ### @esbuild-kit/esm-loader 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @esbuild-kit/esm-loader 可以商用吗？ @esbuild-kit/esm-loader 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @esbuild-kit/esm-loader 的下载量有多少？ 根据 npm 官方下载统计，@esbuild-kit/esm-loader 在 2026/10/14 – 2026/11/12 这 30 天内被下载 119,629,668 次，日均约 3,987,656 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @esbuild-kit/esm-loader 还在维护吗？ 最新版本 2\.6\.5 发布于 2023/09/17（3 年前）；至今共发布 30 个版本，其中过去 12 个月发布了 0 个；首次发布于 2022/05/11。作者已将其标记为弃用，新项目建议寻找替代方案。