JavaScript 模块化开发是将代码拆分为独立、可复用、有明确依赖关系的文件,核心方式为 ES Module(推荐)和 CommonJS;ESM 语法简洁、支持 tree-shaking,需 type="module" 或。mjs;CommonJS 适用于旧 Node.js 项目;实际项目需 Vite 或 Webpack 等工具支持路径别名、资源处理等;模块设计应单一职责、避免循环依赖、配合类型提示。

JavaScript 模块化开发就是把代码拆成独立、可复用、有明确依赖关系的文件,避免全局污染和维护困难。现代 前端 项目基本都依赖模块化,核心方式有 ES Module(浏览器和 Node.js原生支持)和 CommonJS(Node.js 传统方案),现在推荐优先用 ESM。
使用 ES Module(推荐)
ES Module 是 ECMAScript 标准,语法简洁,静态分析能力强,支持 tree-shaking,是当前主流选择。
- 导出用 export:可以命名导出(
export const a = 1;)或默认导出(export default function() {}) - 导入用 import:命名导入写法为
import {a, b} from './utils.js';,默认导入为import utils from './utils.js'; - 注意:ESM 在浏览器中需加
type="module"属性: - Node.js 中启用 ESM 只需将文件后缀改为
.mjs或在package.json中设置"type": "module"
兼容旧项目:CommonJS(Node.js 环境)
在纯 Node.js(尤其老项目或工具脚本)中仍常见,用 require() 和 module.exports,但它是运行时动态加载,不支持静态优化。
- 导出:用
module.exports = {……}或exports.xxx = …… - 导入:用
const utils = require('./utils'); - 注意:CommonJS 不能直接在浏览器中运行,需通过 Webpack、Vite 等打包工具转换
- Node.js 中可混用 ESM 和 CommonJS,但需注意互操作限制(如
import不能直接读取module.exports对象)
打包工具辅助模块化(实际项目必备)
即使用了 ESM,浏览器对路径别名、CSS/ 图片等资源、代码分割的支持仍有限,需要构建工具补足。
立即学习“Java 免费学习笔记(深入)”;
- Vite:开箱即用 ESM,开发时直接跑原生模块,无需编译,适合新项目
- Webpack:生态成熟,支持各种模块格式、懒加载、环境变量等,适合复杂应用
- 配置重点:设置入口(
entry)、输出(output)、解析规则(resolve.alias)、插件(如HtmlWebpackPlugin)
模块设计小建议
模块化不只是语法,更是组织思路。写得好才能真正解耦、易测、好维护。
- 一个模块只做一件事,比如
api.js只封装请求,storage.js只管本地存储 - 尽量用默认导出 + 命名导出组合:默认给主功能,命名给辅助方法(如
export default axios; export const get = ……) - 避免循环依赖:A 导入 B,B 又导入 A → 通常说明职责划分不清,可提取公共逻辑到第三个模块
- 类型提示友好:配合 TypeScript 写
export interface或 JSDoc,提升可读性
基本上就这些。从 import/export 写起,搭配合适工具,再注意模块职责,模块化开发就不复杂但容易忽略细节。