模块与 npm

这一课你将能做到

1. 分别用 CommonJS 和 ESM 编写、导入模块，并说清两者的核心差异
2. 用 npm 完成初始化、安装依赖、配置脚本，理解 package.json 与 lockfile 的分工
3. 读懂语义化版本号 ^1.2.3，预判升级风险

为什么要学

代码一多就必须拆文件，拆完就要解决「文件之间怎么互相引用」——这就是模块系统。而 npm 是 Node 世界的「应用商店」：生态里 200 多万个包，装一个包就能少写几百行代码。

实际开发里最常见的三个场景全和这课有关：接手项目先看 package.json（知道用了什么、怎么跑起来）；装依赖（npm install）；把通用逻辑抽成模块复用。CommonJS 和 ESM 并存的现状会持续很多年，两种都得会读会写——看老项目和看新项目用的可能不是同一套。

先建立图像

一个 Node 项目的依赖世界：

my-app/
├── package.json          ← 项目身份证：名字、依赖清单、脚本
├── package-lock.json     ← 依赖的精确版本锁（提交到 git）
├── node_modules/         ← 依赖的实际代码（不提交 git）
│   ├── dayjs/
│   └── lodash/
└── src/
    ├── index.js          ── require ──►  ./utils/format.js
    └── utils/
        └── format.js

	CommonJS（CJS）	ESM
导入	require()	import
导出	module.exports	export / export default
载入时机	运行时，同步	编译期静态分析
文件后缀	.js（默认）	.mjs 或 package.json 声明 "type": "module"
取目录	__dirname	import.meta.url
江湖地位	老项目、大量存量代码	官方标准、新项目主流

跟着做

步骤 1：第一个 CommonJS 模块

新建 cjs-demo 目录，npm init -y，新建 utils.js：

// utils.js
function formatDate(date) {
  const d = new Date(date);
  const pad = (n) => String(n).padStart(2, '0');
  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
}

function slugify(text) {
  return text.trim().toLowerCase().replace(/\s+/g, '-');
}

module.exports = { formatDate, slugify };   // 对外暴露一个对象

新建 index.js 使用它：

// index.js
const { formatDate, slugify } = require('./utils');   // 相对路径必须以 ./ 开头

console.log(formatDate('2026-10-06'));   // 2026-10-06
console.log(slugify('Hello Node World')); // hello-node-world