Javascript中的模块导出与导入有哪些不同方式?

15次阅读

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

Javascript中的模块导出与导入有哪些不同方式?

CommonJS 的 module.exportsrequire() 怎么用?

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 的 exportimport 有哪些写法?

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 是确定字符串)
  • 打包工具(如 webpackvite)会把 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 行为差异。

立即学习Java免费学习笔记(深入)”;

  • 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 入口。真正复杂场景下,统一构建目标比强行桥接更可控。

text=ZqhQzanResources