在 package.json 中配置 javascript es modules，只需将顶层字段 "type" 的值设置为 "module"。这样设置后，该目录下的所有 .js 文件默认都会被 node.js 当作 es 模块处理，从而支持 import 和 export 语法；若需保持 commonjs 模式，则继续使用 .cjs 后缀或移除该字段。
如何区分单文件的模块类型
当项目根目录未设置全局 type 字段时，Node.js 会根据文件扩展名来决定解析策略：.mjs 强制作为 ES 模块，而 .cjs 强制作为 CommonJS。这种基于扩展名的机制允许在同一项目中混合使用两种模块系统，无需修改配置文件即可实现局部切换。
{
"name": "my-project",
"version": "1.0.0",
"main": "index.cjs"
}
上述配置展示了默认行为。在此状态下，index.mjs 会被识别为 ES 模块，而 index.js 和 index.cjs 均被视为 CommonJS。开发者可以通过重命名文件来快速验证不同模块系统的导入导出差异，例如在 .mjs 中使用 import，在 .cjs 中使用 require。
立即学习“Java免费学习笔记（深入）”；
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
全局启用 ES Modules 后的影响
一旦在 package.json 中添加了 "type": "module"，整个包内的 .js 文件都将遵循 ES 模块规范。这意味着不能再直接使用 require()、module.exports、__dirname 和 __filename 等 CommonJS 特有的变量或函数，必须改用 import 语句及 import.meta.url 来获取当前文件路径信息。
{
"name": "esm-project",
"version": "1.0.0",
"type": "module",
"main": "index.js"
}
在全局启用 ES Modules 后，index.js 的行为发生根本改变。此时若尝试在 index.js 中调用 require()，Node.js 将抛出 ReferenceError。正确的做法是使用动态导入 import() 来加载 CommonJS 依赖，或者将需要兼容 CommonJS 的文件重命名为 .cjs 以隔离模块系统。
如何处理动态导入 CommonJS 依赖
在 "type": "module" 的项目中，若需加载一个 CommonJS 模块（如 lodash），不能直接使用静态 import 语法，因为静态导入要求目标必须是 ES 模块。此时应使用动态 import() 函数，它返回一个 Promise，并在运行时解析模块。
import { createRequire } from 'module';
const require = createRequire(import.meta.url);
// 方式一：使用 createRequire 模拟 require
const _ = require('lodash');
console.log(_.VERSION);
// 方式二：动态 import
async function loadModule() {
const lodash = await import('lodash');
console.log(lodash.VERSION);
}
以上代码演示了两种在 ES 模块环境中加载 CommonJS 库的方法。第一种通过 createRequire 创建了一个局部的 require 函数，使其能在 ES 模块上下文中正常工作；第二种使用异步 import()，适合在需要按需加载或条件加载的场景下使用。这两种方式均能正确获取到 CommonJS 模块导出的内容，避免了模块解析错误。
