JavaScript / TypeScript / 系统课时
导入与导出类型
导入与导出类型
TypeScript 的类型只参与编译检查,运行时并不存在。import type 与 export type 可以把这种依赖显式写出来,避免类型引用被误当成运行时模块依赖,并让生成的 JavaScript 更符合真实执行关系。
学习目标
- 能使用
import type与export type表达纯类型依赖。 - 能区分类型成员和运行时值,并理解它们在编译后的差异。
- 能判断何时使用混合导入,以及哪些写法会导致类型和值混淆。
把类型依赖与值依赖分开
接口、类型别名等只在类型检查阶段存在;常量、函数、类的构造函数则需要在运行时存在。下面三个文件共同组成一个完整示例;单个文件只是片段示例,需要放在同一目录后一起编译运行。
models.ts 同时声明类型和值:
export interface User {
id: string;
name: string;
}
export type UserId = string;
export const runtimeTag = "USER";barrel.ts 明确区分重新导出的类型和值:
export type { User, UserId } from "./models";
export { runtimeTag } from "./models";使用 type-only 导入
调用方只把 User 和 UserId 当作类型使用,因此应通过 import type 导入;真正参与运行的 runtimeTag 使用普通导入。
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);执行编译和运行:
npx tsc --module commonjs --target es2020 --outDir dist models.ts barrel.ts app.ts
node dist/app.js预期输出:
USER true验证类型导入不会进入运行时代码
可以直接检查编译后的 app.js。下面的命令搜索两个类型名;如果它们已被正确擦除,就输出确认信息。
grep -E "UserId|User" dist/app.js || echo "type names erased"预期输出:
type names erased这并不表示文件之间完全没有运行时依赖,因为 runtimeTag 仍然需要从 barrel 加载。type-only 语法的价值在于让“只为类型存在的边”不混入运行时依赖图。
处理混合导入与类
当同一个模块同时提供类型和值时,也可以写成 import { type User, runtimeTag } from "./barrel",把两类成员保留在一条导入语句中。团队如果更看重依赖可见性,分成 import type 和普通 import 往往更醒目。
类同时具有“实例类型”和“运行时构造函数”两种身份。若通过 import type { SomeClass } 导入,它只能用于类型位置,不能执行 new SomeClass() 或访问静态成员;需要构造对象时必须改为普通导入。这样区分后,类型依赖和真正的执行依赖就不会被混在一起。