在 package.json 中配置 type 字段可以控制 node.js 对文件扩展名的解析行为。设置 "type": "module" 后,所有 .js 和 .mjs 文件将被视为 es module;若省略该字段或设为 "commonjs",则默认使用 commonjs 规范。这一配置直接决定了代码中能否直接使用 import/export 语法,以及 require() 是否可用。

如何启用 ES Module 模式
将 type 设置为 "module" 即可启用 ES Module 模式。此时项目根目录下的 .js 文件默认按 ESM 处理,可以使用顶层 await 和原生 import 语句。如果只想让部分文件作为模块,可以将主入口文件重命名为 .mjs,或者保持 type 为 "commonjs"(或不存在)并显式指定文件后缀。
{
"name": "my-app",
"version": "1.0.0",
"type": "module"
}
上述配置使 index.js 成为 ESM 文件。若需混合使用,可保留 package.json 中的 type 为 "commonjs",并将模块文件存为 .mjs,脚本文件存为 .cjs。Node.js 会优先根据 type 判断 .js 文件的类型,再根据扩展名覆盖默认行为。
CommonJS 与 ES Module 的互操作限制
当 type 为 "module" 时,require() 和 __dirname 等 CommonJS 特有变量不可用。反之,若未设置 type 或设为 "commonjs",则无法直接使用 import 关键字。这种互操作性限制是静态的,不能在运行时动态切换。若需在 ESM 中调用 CJS 模块,可使用 import() 动态导入函数;若需在 CJS 中加载 ESM,则必须通过子进程或异步加载方式实现。
将包含oralBroadcastingList、materialList、bgmInfo等字段的JSON视频素材转换为剪映API可用的自然语言描述,用于生成视频制作指令,包括素材匹配、时间轴计算、字幕同步、特殊效果处理等。
// index.mjs (ESM)
import { createRequire } from 'module';
const require = createRequire(import.meta.url);
// 可以在 ESM 中使用 require 加载 CJS 模块
const cjsModule = require('./commonjs-module.cjs');
上述代码展示了如何在 ESM 环境中通过 createRequire 模拟 require 行为。注意 import.meta.url 是 ESM 中专有的元属性,用于获取当前模块的 URL,进而构建相对路径。此方法仅适用于加载同步模块,对于依赖链复杂的场景,建议统一模块系统以避免兼容性问题。
type 配置对动态导入的影响
在 type: "module" 的项目中,动态导入 import('./file.js') 的行为受目标文件自身类型影响。若目标文件是 .js,它将被视为 ESM;若是 .cjs,则被视为 CJS。这种区分允许在同一项目中灵活混合两种模块系统,但要求开发者明确每个文件的实际类型。错误地混合会导致 ERR_REQUIRE_ESM 或 ERR_UNSUPPORTED_DIR_IMPORT 等运行时错误。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










