JavaScript / TypeScript / 系统课时
导出与导入模块
导出与导入模块
TypeScript 模块的关键不是“把文件拆开”,而是用明确的导出入口控制依赖方向。本节用一个可运行示例串起命名导出、默认导出、重命名导入与重新导出,并说明怎样避免模糊的模块边界。
学习目标
- 能使用命名导出、默认导出和对应的导入语法。
- 能用重新导出建立稳定的模块入口。
- 能识别默认导出滥用与 barrel 文件带来的边界问题。
选择合适的导出形式
命名导出适合一个模块暴露多个稳定成员,导入方必须使用公开名称,重构时更容易被编辑器追踪。默认导出适合文件只有一个主要职责的场景,导入方可以自行命名,但名称不统一时也更容易降低可读性。
下面四个文件共同组成一个完整示例;单个文件只是片段示例,需要放在同一目录后一起编译运行。
math.ts 同时提供命名导出和默认导出:
export const PI = 3.14159;
export function circleArea(radius: number): number {
return PI * radius * radius;
}
// 该文件的主要默认能力:把数值限制在指定区间。
export default function clamp(value: number, min: number, max: number): number {
return Math.min(Math.max(value, min), max);
}format.ts 提供另一个命名导出:
export function formatArea(value: number): string {
return `area=${value.toFixed(2)}`;
}用重新导出稳定公共入口
可以增加一个 index.ts,让调用方只依赖统一入口,而不必知道内部文件如何拆分。重新导出还可以顺便改名,但要注意 export { name } from "./module" 只是转发成员,并不会在当前文件创建可直接使用的本地变量。
export { PI, circleArea } from "./math";
export { default as clamp } from "./math";
export { formatArea as format } from "./format";调用方只从公共入口导入:
import { circleArea, clamp, format } from "./index";
const area = circleArea(2);
console.log(format(area));
console.log(clamp(12, 0, 10));在包含这四个文件的目录中执行:
npx tsc --module commonjs --target es2020 --outDir dist math.ts format.ts index.ts app.ts
node dist/app.js预期输出:
area=12.57
10理解导入名称与路径
命名导入使用花括号,名称默认必须与导出一致;需要局部改名时可以写 import { circleArea as areaOfCircle } from "./index"。默认导入不使用花括号,因此 import limit from "./math" 仍然引用同一个默认导出。
模块路径描述的是依赖边界。业务代码如果到处直接引用 ./internal/foo、./internal/bar,说明公共入口没有真正承担边界职责;一旦内部目录重组,调用方会被大面积牵连。
避免重新导出的副作用
index.ts 这类 barrel 文件适合给一个小而稳定的模块集合提供统一入口,但不宜无限向上聚合。大量 export * from 会隐藏真实来源,也更容易制造循环依赖和无意间扩大的公共 API。
公共模块优先显式列出要暴露的成员。默认导出则保留给“一个文件只有一个主要对象或函数”的情况;工具函数、常量集合和可独立使用的多个能力通常更适合命名导出。