17370845950

CommonJS用module.exports导出任意值、require()同步导入浅拷贝对象；ESM用export/import声明式导出导入，绑定实时只读；import()函数支持动态路径和按需加载；混用时需注意type字段、导入语法及default包装问题。

CommonJS 的 module.exports 和 require() 怎么用？

Node.js 早期默认使用 CommonJS，适用于服务端或未启用 ESM 的环境。它的导出是赋值式、可多次覆盖的，导入则是同步执行、返回一个对象的浅拷贝。

• module.exports 可以直接赋值为任意类型（函数、对象、类、原始值），exports 只是它的引用别名，但重新赋值 exports 不会影响 module.exports
• require() 返回的是模块顶层 module.exports 的值，不是实时绑定——即使导出对象后续被修改，已导入的引用不会自动更新
• 不支持循环依赖的“实时”响应：A require B，B require A 时，A 中尚未执行完的 module.exports 会返回一个空对象（或部分初始化的对象）

/* math.js */
module.exports.add = (a, b) => a + b;
module.exports.PI = 3.14159;
/ main.js /
const math = require('./math');
console.log(math.add(2, 3)); // 5

ES Module 的 export 和 import 有哪些写法？

ESM 是标准语法，必须显式声明导出与导入，支持静态分析、tree-shaking，且所有绑定都是实时、只读的（export { x } 导出的是绑定，不是值拷贝）。

• export default 每个模块最多一个，导入时名称可任意；export 命名导出可多个，导入时名称必须严格匹配（或用 as 重命名）
• 不能在条件语句或函数内动态 import() —— 除非用 import() 函数形式（它返回 Promise，属于动态导入，和静态 import 语法不同）
• 顶层 this 在 ESM 中为 undefined，CommonJS 中是当前模块的 exports

/* utils.mjs */
export const clamp = (val, min, max) => Math.min(Math.max(val, min), max);
export default function greet(name) {
  return `Hello, ${name}`;
}
/ app.mjs /
import greet from './utils.mjs';
import { clamp } from './utils.mjs';
console.log(greet('Alice')); // Hello, Alice
console.log(clamp(-5, 0, 10)); // 0

为什么 import() 函数能解决按需加载，而静态 import 不能？

import() 是一个返回 Promise 的函数调用，运行时解析路径、动态请求模块，适合配合路由、条件判断或用户交互触发加载；静态 import 必须在编译/解析阶段确定路径，且路径只能是字符串字面量（不能拼接变量）。

• 路径支持表达式，但最终必须解析为有效 URL 或本地路径，例如 import(`./pages/${page}.js`) 是合法的（只要 page 是确定字符串）
• 打包工具（如 Webpack、Vite）会把 import() 当作代码分割点，生成独立 chunk；静态 import 则默认全量打包（除非配置了 sideEffects 等）
• 错误处理需用 .catch() 或 try/catch，失败不会中断主流程

async function loadComponent(name) {
  try {
    const mod = await import(`./components/${name}.js`);
    return mod.default;
  } catch (err) {
    console.error('Failed to load component:', err);
  }
}

混合使用 CommonJS 和 ESM 时最容易踩哪些坑？

Node.js 从 v12 起支持双模式，但行为受 package.json 的 "type": "module" 或文件扩展名（.mjs / .cjs）控制。混用时最常出问题的是导出/导入不匹配和顶层 this 行为差异。

• require() 无法直接导入 ESM 模块（会报 ERR_REQUIRE_ESM），除非用 import() 或借助 createRequire
• ESM 中 import * as mod from 'cjs-pkg' 得到的是 { default: module.exports, __esModule: true }，需通过 mod.default 访问原始值
• CommonJS 模块里想用 ESM 的 export default，必须写成 module.exports = (await import('./esm.mjs')).default，否则会得到包装对象

跨模块互操作没有银弹，尤其涉及第三方包时，优先查其文档是否标明 exports 字段或提供 require 入口。真正复杂场景下，统一构建目标比强行桥接更可控。