Node.js mjs模式下如何加载cjs文件？自定义loader适配cjs相关问题

内置加载逻辑说明 #

Node.js 在 ESM 模式下加载 CJS 格式文件，走的是独立的内部互操作层，这部分逻辑未对自定义 Loader 暴露公开的可复用接口：

• 当 ESM 加载链路识别到 CJS 格式文件（包括.cjs后缀文件、package.json中type字段不为module的.js文件）时，会直接将其转交内部 CJS 模块加载器处理
• 处理完成后，Node.js 会把 CJS 的module.exports封装为 ESM 的默认导出，开启--experimental-detect-module实验性参数时还会自动推导命名导出，整个流程完全在内部闭环，没有给自定义 Loader 留介入或调用的入口
• 官方文档明确说明自定义 Loader 不支持处理 CJS 文件，核心原因是目前自定义 Loader 仅对接了 ESM 加载链路，CJS 加载链路完全独立，未提供钩子支持

无法复用内置实现的核心原因 #

你没法直接调用 Node.js 内置的 CJS 加载逻辑对接你的自定义 Loader，主要有两点：

• 内置 CJS 加载器依赖大量私有 API，包括 C++ 层的模块解析逻辑、内部模块缓存结构、process上的未公开方法等，自定义 Loader 运行在隔离的上下文环境中，没有权限调用这些私有能力
• 即使你通过在 Loader 中调用require的方式加载 CJS 文件，拿到的导出结果也无法直接注入 ESM 加载链路：ESM 和 CJS 的模块缓存、命名空间完全独立，会出现重复加载、导出结果不一致的问题

可行方案建议 #

你构想的「CJS 转 ESM」是目前业界通用的成熟解决方案，不需要再尝试复用内置逻辑：

• 你可以借助cjs-module-lexer先快速扫描 CJS 文件的导出项，再通过字符串替换或者轻量转译工具把module.exports、require相关逻辑转换为 ESM 标准的import/export语法
• 转译完成后直接将生成的 ESM 代码返回给 Loader 的load钩子即可，兼容性和性能都能满足需求

内容的提问来源于stack exchange，提问作者nic ferrier