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";理解导入规则后,模块之间的依赖关系会更加清晰,也能避免大型项目中常见的路径和成员引用错误。
按自己的节奏,确认真正理解。