JavaScript / TypeScript / 系统课时

使用动态导入

使用动态导入

动态 import() 让模块在代码执行到指定位置时才异步加载,适合条件功能、较重依赖和按需初始化。本课将完成一个可运行示例,并用 typeof import() 保留模块命名空间的准确类型。

学习目标

  • 使用 import() 异步加载并访问模块导出
  • 理解动态导入返回值与默认导出的访问方式
  • 使用 typeof import() 声明精确的模块类型

动态导入的返回值

import("./module.js") 是表达式,不是静态导入声明。它会异步请求模块并返回 Promise,解析结果是模块命名空间对象,因此命名导出通过属性访问,默认导出则位于 default 属性。动态导入可用于条件加载和延迟加载。:contentReference[oaicite:5]{index=5}

当参数是编译器能够解析的模块路径时,TypeScript 会推断导入结果;需要复用或显式约束该类型时,可以写 typeof import("./module.js")。这种类型查询只引用模块类型,不会在运行时额外加载模块。:contentReference[oaicite:6]{index=6}

创建可运行示例

先创建项目配置。package.json:

json
{
  "name": "dynamic-import-demo",
  "private": true,
  "type": "module",
  "scripts": {
    "build": "tsc",
    "start": "node dist/main.js"
  },
  "devDependencies": {
    "typescript": "^5.9.0"
  }
}

tsconfig.json:

json
{
  "compilerOptions": {
    "target": "ES2022",
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "rootDir": "src",
    "outDir": "dist",
    "strict": true
  },
  "include": ["src"]
}

创建 src/math.ts:

ts
export function add(left: number, right: number): number {
  return left + right;
}

export default function multiply(left: number, right: number): number {
  return left * right;
}

创建 src/main.ts:

ts
type MathModule = typeof import("./math.js");

async function main(): Promise<void> {
  // 只有执行到这里时,运行时才请求并初始化 math 模块。
  const math: MathModule = await import("./math.js");

  const sum = math.add(2, 3);
  const product = math.default(4, 5);

  console.log(`sum=${sum}`);
  console.log(`product=${product}`);
}

main().catch((error: unknown) => {
  console.error(error);
});

安装依赖、编译并运行:

bash
npm install --silent
npm run build --silent
npm run start --silent

依赖安装日志会随 npm 版本变化,关键预期输出为:

text
sum=5
product=20

这里的 MathModule 与实际模块命名空间保持同步。若 math.ts 删除或修改导出,main.ts 会在编译阶段得到对应错误,而不必手工维护重复接口。

在条件成立时加载

动态导入最常见的价值是把加载动作放进条件或函数内部:

ts
async function calculate(
  mode: "add" | "multiply",
  left: number,
  right: number
): Promise<number> {
  const math = await import("./math.js");

  return mode === "add"
    ? math.add(left, right)
    : math.default(left, right);
}

这是片段示例,依赖上一节的 math.ts。调用 calculate("add", 2, 3) 的预期结果为 5。在浏览器打包项目中,构建工具还可能据此拆分独立代码块;具体文件名和加载时机由构建工具配置决定。:contentReference[oaicite:7]{index=7}

关键边界

动态导入路径尽量保持为明确字符串。编译器和打包器更容易定位模块、检查导出并生成正确产物;完全由任意字符串拼接的路径可能无法被静态分析。

不要把导入结果误认为默认导出。以下为片段示例,依赖前面的 math.ts,并且需要放在异步函数或支持顶层 await 的模块中:

ts
const moduleNamespace = await import("./math.js");
const multiply = moduleNamespace.default;

第一行得到包含全部导出的命名空间对象,第二行才取得默认导出函数。动态 import() 在 Node 模块解析中始终采用 import 路径规则,因此 Node ESM 的相对路径同样需要正确扩展名。:contentReference[oaicite:8]{index=8}

本课总结

  • import() 返回模块命名空间对象的 Promise
  • 命名导出直接访问属性,默认导出通过 default 属性访问
  • typeof import() 能复用真实模块类型,避免手工复制接口

下一课预告

下一课将继续处理异步代码,结合 Promise 的类型参数组织成功结果、失败路径与并发任务。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用动态导入

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

登录哪都通