JavaScript / TypeScript / 系统课时

导出与导入模块

导出与导入模块

TypeScript 模块的关键不是“把文件拆开”,而是用明确的导出入口控制依赖方向。本节用一个可运行示例串起命名导出、默认导出、重命名导入与重新导出,并说明怎样避免模糊的模块边界。

学习目标

  • 能使用命名导出、默认导出和对应的导入语法。
  • 能用重新导出建立稳定的模块入口。
  • 能识别默认导出滥用与 barrel 文件带来的边界问题。

选择合适的导出形式

命名导出适合一个模块暴露多个稳定成员,导入方必须使用公开名称,重构时更容易被编辑器追踪。默认导出适合文件只有一个主要职责的场景,导入方可以自行命名,但名称不统一时也更容易降低可读性。

下面四个文件共同组成一个完整示例;单个文件只是片段示例,需要放在同一目录后一起编译运行。

math.ts 同时提供命名导出和默认导出:

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 提供另一个命名导出:

ts
export function formatArea(value: number): string {
  return `area=${value.toFixed(2)}`;
}

用重新导出稳定公共入口

可以增加一个 index.ts,让调用方只依赖统一入口,而不必知道内部文件如何拆分。重新导出还可以顺便改名,但要注意 export { name } from "./module" 只是转发成员,并不会在当前文件创建可直接使用的本地变量。

ts
export { PI, circleArea } from "./math";
export { default as clamp } from "./math";
export { formatArea as format } from "./format";

调用方只从公共入口导入:

ts
import { circleArea, clamp, format } from "./index";

const area = circleArea(2);

console.log(format(area));
console.log(clamp(12, 0, 10));

在包含这四个文件的目录中执行:

bash
npx tsc --module commonjs --target es2020 --outDir dist math.ts format.ts index.ts app.ts
node dist/app.js

预期输出:

text
area=12.57
10

理解导入名称与路径

命名导入使用花括号,名称默认必须与导出一致;需要局部改名时可以写 import { circleArea as areaOfCircle } from "./index"。默认导入不使用花括号,因此 import limit from "./math" 仍然引用同一个默认导出。

模块路径描述的是依赖边界。业务代码如果到处直接引用 ./internal/foo、./internal/bar,说明公共入口没有真正承担边界职责;一旦内部目录重组,调用方会被大面积牵连。

避免重新导出的副作用

index.ts 这类 barrel 文件适合给一个小而稳定的模块集合提供统一入口,但不宜无限向上聚合。大量 export * from 会隐藏真实来源,也更容易制造循环依赖和无意间扩大的公共 API。

公共模块优先显式列出要暴露的成员。默认导出则保留给“一个文件只有一个主要对象或函数”的情况;工具函数、常量集合和可独立使用的多个能力通常更适合命名导出。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

导出与导入模块

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通