JavaScript / TypeScript / 系统课时
类型导入与导出
类型导入与导出
本课解决“只需要类型,却意外形成运行时导入”的问题。你将使用 import type 和 export type 明确类型依赖,并观察它们在编译后如何被移除。
学习目标
- 使用
import type与export type - 区分类型空间和值空间
- 通过编译结果验证类型导入不会进入运行时代码
类型专用导入
import type 引入的名称只能用于类型位置,编译为 JavaScript 时会被移除;export type 同样只导出类型信息。项目文件:
依次创建 package.json、tsconfig.json、types.ts、format.ts 和 main.ts。
types.ts 只导出类型:
export type User = {
name: string;
age: number;
};format.ts 同时依赖类型并导出运行时函数:
import type { User } from "./types.js";
export function formatUser(user: User): string {
return `${user.name}(${user.age})`;
}main.ts 引入值和类型:
import { formatUser } from "./format.js";
import type { User } from "./types.js";
const user: User = { name: "Ada", age: 36 };
console.log(formatUser(user));package.json:
{
"type": "module",
"scripts": {
"build": "tsc",
"start": "node dist/main.js"
}
}tsconfig.json:
{
"compilerOptions": {
"target": "ES2022",
"module": "NodeNext",
"moduleResolution": "NodeNext",
"verbatimModuleSyntax": true,
"strict": true,
"outDir": "dist"
},
"include": ["*.ts"]
}执行:
npm install --save-dev typescript@5.9.3
npm run build
npm run start预期输出:
Ada(36)编译后的 main.js 只保留 formatUser 的值导入,不会包含对 types.js 的导入。verbatimModuleSyntax 让源码中的导入导出意图更直接地反映到输出中。
类型空间和值空间
接口和类型别名只存在于类型空间,函数、变量、类和枚举通常也有运行时值。类既能当作值创建实例,也能在类型位置描述实例,因此不要把需要运行时访问的类写进 import type。
统一出口文件
类型可以通过入口文件重新导出:
export type { User } from "./types.js";
export { formatUser } from "./format.js";这是模块导出片段。第一行只建立类型出口,第二行建立运行时出口,调用方能够从同一入口导入,同时保持二者边界清晰。
建立可重复的练习项目
在独立目录保存上面的五个文件,并安装开发依赖 TypeScript 5.9.3,再执行构建脚本。不要在 CommonJS 包里直接照搬这个 ESM 配置;package.json 的 type 与 NodeNext 会共同决定源文件和输出文件的模块形式。路径中的 .js 指向最终运行文件,编译器会按规则寻找相应 .ts 源码。
验证时打开 dist/main.js 与 dist/format.js:前者只保留 formatUser 导入,后者没有 User 类型导入。types.ts 可以输出空模块文件,这与“没有运行时导入它”并不矛盾。不要把文件是否生成与依赖边是否存在混成一个判断。
如果某模块有注册插件等副作用,只使用 import type 不会执行它,必须另外设计显式的值导入或初始化调用。类若要用于 new 或 instanceof,也必须通过值导入获得构造函数。迁移已有代码时先明确哪些导入依赖副作用,再检查构建产物和实际启动行为。