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。

json
{
  "name": "esm-basics-demo",
  "private": true,
  "type": "module"
}

保存后,app.js 中可以直接使用静态 import。如果不能修改 package.json,也可以把入口和模块文件改为 .mjs,用扩展名明确指定 ESM。

写出具名导出和默认导出

具名导出适合同一文件暴露多个有名称的能力;默认导出适合暴露一个主要值或主要函数。下面的 money.js 同时使用两种形式,其中默认导出只能有一个,具名导出可以有多个。

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。

js
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 的目录运行:

bash
node app.js

预期输出:

text
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'。项目内保持一种稳定的导出命名规则,能减少重构时出现“文件存在但导出名对不上”的启动错误。

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

目录与阅读设置

阅读设置

17

记录一个想法

ES 模块基础

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

登录哪都通