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 只导出类型:

ts
export type User = {
  name: string;
  age: number;
};

format.ts 同时依赖类型并导出运行时函数:

ts
import type { User } from "./types.js";

export function formatUser(user: User): string {
  return `${user.name}(${user.age})`;
}

main.ts 引入值和类型:

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:

json
{
  "type": "module",
  "scripts": {
    "build": "tsc",
    "start": "node dist/main.js"
  }
}

tsconfig.json:

json
{
  "compilerOptions": {
    "target": "ES2022",
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "verbatimModuleSyntax": true,
    "strict": true,
    "outDir": "dist"
  },
  "include": ["*.ts"]
}

执行:

bash
npm install --save-dev typescript@5.9.3
npm run build
npm run start

预期输出:

text
Ada(36)

编译后的 main.js 只保留 formatUser 的值导入,不会包含对 types.js 的导入。verbatimModuleSyntax 让源码中的导入导出意图更直接地反映到输出中。

类型空间和值空间

接口和类型别名只存在于类型空间,函数、变量、类和枚举通常也有运行时值。类既能当作值创建实例,也能在类型位置描述实例,因此不要把需要运行时访问的类写进 import type。

统一出口文件

类型可以通过入口文件重新导出:

ts
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,也必须通过值导入获得构造函数。迁移已有代码时先明确哪些导入依赖副作用,再检查构建产物和实际启动行为。

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

目录与阅读设置

阅读设置

17

记录一个想法

类型导入与导出

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

登录哪都通