JavaScript / TypeScript / 系统课时

导入与导出类型

导入与导出类型

TypeScript 的类型只参与编译检查,运行时并不存在。import type 与 export type 可以把这种依赖显式写出来,避免类型引用被误当成运行时模块依赖,并让生成的 JavaScript 更符合真实执行关系。

学习目标

  • 能使用 import type 与 export type 表达纯类型依赖。
  • 能区分类型成员和运行时值,并理解它们在编译后的差异。
  • 能判断何时使用混合导入,以及哪些写法会导致类型和值混淆。

把类型依赖与值依赖分开

接口、类型别名等只在类型检查阶段存在;常量、函数、类的构造函数则需要在运行时存在。下面三个文件共同组成一个完整示例;单个文件只是片段示例,需要放在同一目录后一起编译运行。

models.ts 同时声明类型和值:

ts
export interface User {
  id: string;
  name: string;
}

export type UserId = string;

export const runtimeTag = "USER";

barrel.ts 明确区分重新导出的类型和值:

ts
export type { User, UserId } from "./models";
export { runtimeTag } from "./models";

使用 type-only 导入

调用方只把 User 和 UserId 当作类型使用,因此应通过 import type 导入;真正参与运行的 runtimeTag 使用普通导入。

ts
import type { User, UserId } from "./barrel";
import { runtimeTag } from "./barrel";

const id: UserId = "u-1";
const user: User = { id, name: "Ada" };

// 运行时只需要 runtimeTag,两个类型名都会在编译后消失。
console.log(runtimeTag, user.id === id);

执行编译和运行:

bash
npx tsc --module commonjs --target es2020 --outDir dist models.ts barrel.ts app.ts
node dist/app.js

预期输出:

text
USER true

验证类型导入不会进入运行时代码

可以直接检查编译后的 app.js。下面的命令搜索两个类型名;如果它们已被正确擦除,就输出确认信息。

bash
grep -E "UserId|User" dist/app.js || echo "type names erased"

预期输出:

text
type names erased

这并不表示文件之间完全没有运行时依赖,因为 runtimeTag 仍然需要从 barrel 加载。type-only 语法的价值在于让“只为类型存在的边”不混入运行时依赖图。

处理混合导入与类

当同一个模块同时提供类型和值时,也可以写成 import { type User, runtimeTag } from "./barrel",把两类成员保留在一条导入语句中。团队如果更看重依赖可见性,分成 import type 和普通 import 往往更醒目。

类同时具有“实例类型”和“运行时构造函数”两种身份。若通过 import type { SomeClass } 导入,它只能用于类型位置,不能执行 new SomeClass() 或访问静态成员;需要构造对象时必须改为普通导入。这样区分后,类型依赖和真正的执行依赖就不会被混在一起。

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

目录与阅读设置

阅读设置

17

记录一个想法

导入与导出类型

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

登录哪都通