Node.js / 系统课时
ES 模块基础
ES 模块基础
ES 模块用 export 声明对外能力,用 import 引入依赖。完成本课后,你会配置 Node.js 以 ESM 方式运行,并能正确组合默认导出、具名导出和相对路径导入。
学习目标
- 会用
package.json的type字段明确启用 ES 模块。 - 会编写具名导出、默认导出,并在另一个文件中正确导入。
- 能定位导出名不匹配、相对路径缺少扩展名等常见错误。
用 package.json 明确启用 ES 模块
项目使用 .js 文件时,最直接的做法是在最近一层 package.json 中写入 "type": "module"。这样该包范围内的 .js 会按 ES 模块解析,不必把每个文件改成 .mjs。
{
"name": "esm-basics-demo",
"private": true,
"type": "module"
}保存后,app.js 中可以直接使用静态 import。如果不能修改 package.json,也可以把入口和模块文件改为 .mjs,用扩展名明确指定 ESM。
写出具名导出和默认导出
具名导出适合同一文件暴露多个有名称的能力;默认导出适合暴露一个主要值或主要函数。下面的 money.js 同时使用两种形式,其中默认导出只能有一个,具名导出可以有多个。
export const taxRate = 0.06;
export function total(price, rate) {
return price * (1 + rate);
}
// 默认导出代表这个模块最主要的格式化能力。
export default function formatMoney(value) {
return `$${value.toFixed(2)}`;
}具名导入时名称必须与导出一致,例如 taxRate 和 total;默认导入的本地名称可以自定义。需要改具名导入的本地名称时,可写成 import { total as calcTotal } from './money.js'。
导入模块并验证结果
创建 app.js,默认导入写在花括号外,具名导入写在花括号内。Node.js 的 ESM 对相对文件说明符要求写出扩展名,因此这里使用 ./money.js,而不是省略成 ./money。
import formatMoney, { taxRate, total } from './money.js';
const subtotal = 100;
const finalAmount = total(subtotal, taxRate);
console.log(taxRate);
console.log(formatMoney(finalAmount));在包含 package.json、money.js 和 app.js 的目录运行:
node app.js预期输出:
0.06
$106.00这说明默认导出和两个具名导出都已被正确解析。若实际金额不同,先检查传入 total() 的价格和税率;若程序在启动时就报模块错误,则先检查导入路径与导出名称。
区分最常见的导入错误
默认导出不能放进具名导入的花括号中,具名导出也不能凭空改名。下面这组对照可以直接用于排错,尤其适合看到 does not provide an export named 一类启动错误时逐项检查。
| 需求 | 正确写法 | 常见错误 |
|---|---|---|
| 导入默认导出 | import formatMoney from './money.js' |
import { formatMoney } from './money.js' |
| 导入具名导出 | import { total } from './money.js' |
import total from './money.js' |
| 给具名导入改本地名 | import { total as calcTotal } from './money.js' |
直接写一个未导出的名称 |
| 导入本地文件 | import './setup.js' |
在 Node.js ESM 中省略相对文件扩展名 |
如果只需要执行某个模块的顶层代码而不接收导出值,可使用 import './setup.js'。项目内保持一种稳定的导出命名规则,能减少重构时出现“文件存在但导出名对不上”的启动错误。