JavaScript / TypeScript / 系统课时

使用 import 引入模块

使用 import 引入模块

本篇解决 JavaScript 模块之间如何建立依赖关系的问题。你将学习如何使用 import 引入其他文件导出的成员,并掌握命名导入、默认导入、重命名以及浏览器模块脚本的使用方式。

学习目标

  • 掌握 import 的不同导入形式
  • 理解导入名称与导出名称之间的关系
  • 学会在浏览器环境中正确加载 ES 模块

使用命名导入

当模块使用命名导出时,导入方需要使用相同名称,并通过花括号指定成员。

例如模块提供多个工具函数:

js
// math.js
export function add(a, b) {
  return a + b;
}

export function multiply(a, b) {
  return a * b;
}

其他文件可以这样导入:

js
// app.js
import { add, multiply } from "./math.js";

console.log(add(2, 3));
console.log(multiply(2, 3));

预期输出

text
5
6

命名导入的优势是依赖关系明确,代码阅读者可以直接看到当前文件使用了模块中的哪些能力。

使用默认导入

如果模块通过 export default 导出成员,导入时不需要花括号,并且可以自定义名称。

js
// logger.js
export default class Logger {
  log(message) {
    console.log(message);
  }
}

导入方式如下:

js
import AppLogger from "./logger.js";

const logger = new AppLogger();
logger.log("started");

预期输出

text
started

默认导入适合模块只有一个主要职责的情况,例如一个页面组件、一个服务类或一个核心配置对象。

重命名导入成员

当多个模块存在同名导出,或者当前文件希望使用更符合上下文的名称时,可以使用 as 重命名。

js
import { formatDate as formatTime } from "./date.js";

console.log(formatTime(new Date()));

预期结果

text
调用 formatDate 函数,并在当前模块中以 formatTime 名称使用

重命名只影响当前文件中的引用名称,不会改变原模块的导出定义。

在浏览器中加载模块脚本

浏览器默认按照普通脚本执行 JavaScript 文件,如果需要使用 import 和 export,必须将入口脚本声明为模块。

html
<script type="module" src="./app.js"></script>

模块脚本具有自己的作用域,并且支持文件之间的依赖解析。

常见导入错误

模块导入失败通常来自几个原因:

  • 导入名称与命名导出名称不一致
  • 默认导出使用了花括号
  • 文件路径缺少正确扩展名
  • 浏览器页面没有使用 type="module"

例如下面写法会失败:

js
// 错误示例
import { Logger } from "./logger.js";

如果 logger.js 使用的是默认导出,正确方式应该是:

js
import Logger from "./logger.js";

理解导入规则后,模块之间的依赖关系会更加清晰,也能避免大型项目中常见的路径和成员引用错误。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 import 引入模块

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

登录哪都通