JavaScript / TypeScript / 系统课时
使用 export 导出模块成员
使用 export 导出模块成员
本篇解决 JavaScript 模块如何向外暴露代码的问题。你将学习如何使用命名导出和默认导出组织模块边界,让变量、函数和类能够被其他文件安全复用。
学习目标
- 理解命名导出与默认导出的区别和适用场景
- 掌握使用 export 暴露模块成员的常见写法
- 能根据模块职责设计更清晰的导出结构
为什么需要模块导出
在实际项目中,一个文件通常只负责一组相关功能。例如工具函数、业务逻辑或组件定义都应该被拆分到独立模块中。模块内部声明的变量默认只在当前文件有效,需要通过导出机制明确告诉 JavaScript 哪些内容可以被其他模块使用。
export 的作用就是建立模块公开接口。其他文件不需要知道模块内部如何实现,只需要通过导出的成员完成调用。
使用命名导出
命名导出适合一个模块提供多个具有明确名称的成员。导入时必须使用对应的名称,因此代码可读性较强。
js
// math.js
export function add(a, b) {
return a + b;
}
export const version = "1.0.0";
export class Calculator {
multiply(a, b) {
return a * b;
}
}预期输出
text
模块 math.js 暴露 add、version、Calculator 三个成员也可以先声明成员,再统一导出:
js
function subtract(a, b) {
return a - b;
}
const name = "calculator";
export { subtract, name };这种写法适合文件底部集中管理公开接口,方便快速查看模块提供了哪些能力。
使用默认导出
默认导出用于一个模块只有一个核心成员的情况。一个模块只能有一个默认导出。
js
// user.js
export default class User {
constructor(name) {
this.name = name;
}
}默认导出的名称由导入方决定,因此导入时不需要保持原名称。
js
import Account from "./user.js";
const user = new Account("Tom");
console.log(user.name);预期输出
text
Tom命名导出与默认导出的选择
两种导出方式并不是互斥的,可以根据模块职责选择。
| 类型 | 特点 | 适用场景 |
|---|---|---|
| 命名导出 | 名称固定,可导出多个成员 | 工具库、多个函数集合 |
| 默认导出 | 一个模块一个主要成员 | 组件、类、单一功能模块 |
例如一个日期工具模块可能包含多个函数:
js
export function formatDate(date) {
return date.toISOString();
}
export function parseDate(value) {
return new Date(value);
}而一个用户模型文件通常只需要默认导出一个类。
设计模块边界时的注意事项
导出的内容应该代表模块对外提供的能力,而不是暴露所有内部实现。过多导出内部变量会增加模块之间的耦合,使后续修改更加困难。
实际开发中,可以优先导出稳定的函数、类或配置对象,把辅助方法保留在模块内部。当一个模块的导出成员越来越多时,通常意味着它承担了过多职责,需要进一步拆分。
按自己的节奏,确认真正理解。