07.3 阶段 2:模块体系与包管理
所属:全栈开发面试题库 / 学习路径 / 07 Node.js 全栈
本页目录
一、阶段定位
阶段 1 讲了事件循环与核心 API,但"代码怎么拆成多个文件、怎么互相引用"这个问题一直没展开。本阶段解决两件事:模块体系(CJS 与 ESM)和包管理(npm/pnpm/yarn、lock 文件、workspaces)。这一层是工程化的地基——后面写 TypeScript、写框架、发私有库,全部建立在"模块怎么加载、依赖怎么解析"之上。
与前后阶段的衔接:往上接 阶段 1 运行时原理与核心 API,那里你已经知道 Node 在启动后先跑模块加载再进事件循环;本阶段把加载规则展开。往下接 阶段 3 TypeScript 工程化,TypeScript 的 moduleResolution 选项直接决定按 CJS 还是 ESM 规则解析,不理解本阶段会看不懂 tsconfig.json。
本阶段原有的四个卡点,展开成可判断的现象依据:
- 混用 require 与 import 报模块错误。判断标准:在
"type": "module"的项目里写require("fs"),看到ReferenceError: require is not defined;或反过来在 CJS 项目里import fs from "fs",看到Cannot use import statement outside a module。 - exports 与 module.exports 互相覆盖导致导出丢失。判断标准:写了
module.exports = foo又写exports.bar = 1,结果外部require后bar没了;或反过来写exports = foo后整个导出变空。 - 循环依赖下拿到空对象仍不理解原因。判断标准:A require B、B 又 require A,运行时 A 里拿到的 B 是
{},访问属性报undefined is not a function,但单独跑每个文件都没问题。 - 把 lock 文件当成可随意删除的产物。判断标准:删了
package-lock.json或pnpm-lock.yaml后重装,依赖版本悄悄变了;或 CI 里用npm install而不是npm ci,每次构建版本不一致。
二、阶段目标与投入
| 能力目标(可验证的行为) | 验证方式 |
|---|---|
| 能在 CJS 与 ESM 项目里正确写 require 与 import,不混用报错 | 在 "type": "module" 里用 import.meta.url 拿到 __dirname |
能解释 module.exports 与 exports 的关系,修掉导出丢失 |
写两个文件,互相 require,导出正确 |
| 能解释循环依赖下为什么拿到空对象,能重构掉 | 写 A↔B 循环依赖复现,再用依赖倒置修掉 |
能读懂 package.json 的 exports 字段,用条件导出区分 import/require |
发一个包,Node 用 import 走 ESM 分支、require 走 CJS 分支 |
| 能用 pnpm workspace 建两个互相引用的本地包 | pnpm install 后两个包能互相 import |
| 能说明幽灵依赖在 pnpm 严格模式下为何被阻止 | 引用一个没在 package.json 声明的包,pnpm 报错 |
建议学时:
- 全职(每天 4–6 小时):2 周,约 50 小时。CJS 与 ESM 15 小时、包解析与 exports 10 小时、循环依赖 5 小时、pnpm/workspaces 15 小时、lock 与安全审计 5 小时。
- 在职(每天 2 小时):5 周。pnpm workspaces 是现代 Node 团队标配,时间要给够。
学时分配建议:CJS/ESM 差异 25%、包解析与 exports 15%、循环依赖 10%、npm/pnpm/yarn 差异 20%、lock 文件与 CI 10%、workspaces/monorepo 15%、私有 registry 与审计 5%。
三、先修自检
| 先修项 | 合格标准 | 不合格时回到 |
|---|---|---|
| Node 基本运行 | node script.js、node -v 正常 |
07.1 阶段 0 |
| package.json 字段 | 知道 dependencies、scripts、name |
07.1 阶段 0 |
| 事件循环基础 | 知道模块加载在事件循环前 | 07.2 阶段 1 |
| 异步基础 | 能写 async/await | 07.1 阶段 0 |
| npm 基本命令 | npm install、npm init 正常 |
07.1 阶段 0 |
四、知识地图
| 模块 | 知识点 | 掌握程度 | 对应题库章节 |
|---|---|---|---|
| CJS | require、module.exports、exports、require.cache、__dirname |
能讲清原理 | 04.2 Node.js |
| ESM | import/export、动态 import()、import.meta.url、__dirname 替代 |
能讲清原理 | 04.2 Node.js |
| 循环依赖 | CJS 部分加载、ESM live binding、空对象现象 | 能讲清原理 | 04.2 Node.js |
| 包解析 | node_modules 层级、main/module/exports、条件导出 |
会用 | 03.6 前端工程化 |
| 包管理器 | npm/pnpm/yarn、依赖提升、幽灵依赖、硬链接 | 能讲清原理 | 03.6 前端工程化 |
| lock 文件 | package-lock.json、pnpm-lock.yaml、npm ci、版本锁定 |
会用 | 03.6 前端工程化 |
| workspaces | workspaces 字段、本地包互引、版本发布 |
会用 | 03.6 前端工程化 |
| 安全与发布 | npm audit、私有 registry、.npmrc |
会用 | 03.6 前端工程化 |
进度管理建议:CJS/ESM 差异与包解析必须到"能讲清原理",workspaces 到"会用"。
五、分模块精讲
5.1 CJS:require、module.exports 与缓存
为什么需要它:CJS 是 Node 长达十多年的模块体系,require 在 CommonJS 项目里无处不在。不理解它的缓存与导出机制,就会反复遇到"改了代码不生效""导出是 undefined"这类问题。
核心机制:
require("xxx")做四件事:按路径规则找到文件、编译并执行、把module.exports返回、按文件绝对路径缓存。- 每个模块在 Node 里被包装成一个函数:
(function(exports, require, module, __filename, __dirname) { ... })。exports是module.exports的引用,两者指向同一个对象。 - 关键:
exports只是module.exports的快捷引用。一旦你写module.exports = foo(重新赋值整个对象),exports就与新对象脱钩了,之后再写exports.bar = 1是在旧对象上加属性,外部根本看不到。 require.cache是缓存表,key 是文件绝对路径。同一文件第二次 require 直接返回缓存的module.exports,不会重新执行。- 模块加载是同步的、按图深度优先。
最小可运行示例:
// utils.js
// 错误写法:先整体赋值,再往 exports 加属性
const obj = { name: "demo" };
module.exports = obj; // 整体替换 exports 指向
exports.age = 18; // 这一步作用在旧的空对象上,外部看不到
// 正确写法:要么整体赋值,要么往 exports 上加属性
// module.exports = { name: "demo", age: 18 };
// 或者:
// exports.name = "demo";
// exports.age = 18;
// main.js
const utils = require("./utils");
console.log(utils.name); // demo
console.log(utils.age); // undefined:因为 exports 与 module.exports 脱钩了
// require 缓存实验
const a = require("./utils");
const b = require("./utils");
console.log(a === b); // true:同一文件返回同一个对象
delete require.cache[require.resolve("./utils")]; // 清缓存
const c = require("./utils");
console.log(a === c); // false:重新执行了
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 导出的属性是 undefined | 先 module.exports = foo 再 exports.bar = 1 |
统一只往 exports 加属性,或只整体 module.exports = |
| 改了源码 require 还是旧值 | require 缓存 | 清 require.cache,或用 --watch 重启 |
Cannot find module './utils' |
路径拼错、缺扩展名(CJS 下扩展名可省略) | 看相对路径,确认文件存在 |
循环 require 拿到 {} |
模块未加载完,返回半成品 | 见 5.4 节 |
面试考法:"module.exports 和 exports 的区别""require 是同步还是异步"。答到 exports 是 module.exports 的引用、重新赋值会脱钩;require 是同步深度优先加载。
5.2 ESM:import/export 与 __dirname 替代
为什么需要它:ESM 是 TC39 标准模块体系,Node 14+ 支持,现代框架(Next.js、NestJS、Vite 生态)默认 ESM。CJS 项目里那种 require 在 ESM 里直接报 require is not defined。
核心机制:
- ESM 通过
package.json的"type": "module"启用;.mjs扩展名无论 type 如何都按 ESM 解析。 import是提升的(hoisted):整个模块所有 import 会先执行完,再执行模块正文。这与 CJS 的"遇到 require 才加载"不同。- ESM 没有
__dirname、__filename、require、module这些 CJS 变量。替代写法:__dirname→import.meta.url(文件 URL)+new URL(".", import.meta.url)- 实际取目录:
path.dirname(new URL(import.meta.url).pathname),或用fileURLToPath(import.meta.url)。
- 动态 import:
const mod = await import("./utils.js"),返回 Promise,可以在运行时按条件加载。 - ESM 的导出是 live binding:导入方看到的是绑定,不是快照。CJS 循环依赖拿到的是"当时的对象",ESM 拿到的是"实时绑定"。
- 错误信息:
Cannot use import statement outside a module(CJS 里写了 import);ReferenceError: require is not defined(ESM 里写了 require)。
最小可运行示例:
// package.json
// { "type": "module" }
// utils.mjs
export function greet(name) { return "hi " + name; }
export const VERSION = "1.0.0";
// main.mjs
import { greet, VERSION } from "./utils.mjs";
console.log(greet("Ann"), VERSION);
// 取 __dirname 的替代写法
import { fileURLToPath } from "url";
import { dirname, join } from "path";
const __filename = fileURLToPath(import.meta.url);
const __dirname = dirname(__filename);
console.log("当前目录:", __dirname);
console.log("配置文件:", join(__dirname, "config.json"));
// 动态 import
const shouldLoad = true;
if (shouldLoad) {
const extra = await import("./extra.mjs");
extra.run();
}
# 混用报错
# 在 "type": "module" 项目里写 require("./utils.js")
# ReferenceError: require is not defined in ES module scope
# 在 CJS 项目里写 import ...
# SyntaxError: Cannot use import statement outside a module
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
require is not defined |
ESM 文件里用了 require | 改成 import,或用 createRequire |
__dirname is not defined |
ESM 没有 CJS 变量 | 用 fileURLToPath(import.meta.url) |
import 路径忘了扩展名 |
ESM 要求写完整扩展名(.js/.mjs) | 补全 ./utils.js,不要只写 ./utils |
ERR_REQUIRE_ESM |
在 CJS 里 require 一个 ESM 包 | 改用动态 await import(),或把包改成双格式 |
面试考法:"CJS 与 ESM 有什么区别""为什么 ESM 没有 __dirname"。答到:import 提升、live binding、异步加载、没有 CJS 变量;用 import.meta.url 替代。
5.3 包解析规则与 exports 字段
为什么需要它:当你 import "lodash" 时,Node 到底怎么找到这个包、找到哪个文件?这决定了你能不能用 import x from "pkg"、能不能按条件区分 import 和 require。
核心机制:
- Node 从当前文件所在目录开始,逐级向上找
node_modules/lodash/。第一个命中的目录就是包根。 - 包根找到
package.json:- 有
exports字段时,优先按 exports 解析,忽略main/module/browser。 - 没有
exports时,按main(默认index.js)找入口。
- 有
exports是一个映射,key 是条件(import、require、default、types),value 是实际文件路径。条件导出让一个包既能被import(ESM)也能被require(CJS)使用。import条件给 ESM 入口,require条件给 CJS 入口,default是兜底。- 子路径导出:
exports里写"./utils": "./dist/utils.js",外部才能import "pkg/utils";没声明的子路径外部不可访问,这是包的封装边界。
最小可运行示例:
{
"name": "my-lib",
"version": "1.0.0",
"type": "module",
"exports": {
".": {
"import": "./dist/index.mjs",
"require": "./dist/index.cjs"
},
"./utils": {
"import": "./dist/utils.mjs",
"require": "./dist/utils.cjs"
}
}
}
// 外部使用
import mainPkg from "my-lib"; // 走 ./dist/index.mjs
const cjsPkg = require("my-lib"); // 走 ./dist/index.cjs
import utils from "my-lib/utils"; // 走 ./dist/utils.mjs
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
ERR_PACKAGE_PATH_NOT_EXPORTED |
子路径没在 exports 声明 | 在 exports 里加对应映射 |
| import 拿到的是 CJS 文件 | exports 条件没写对 | 检查 import 与 require 分支 |
改了 main 不生效 |
有 exports 时 main 被忽略 |
改 exports 字段 |
| 包在浏览器里跑不通 | browser 字段与 exports 冲突 |
构建工具按自己规则解析,Node 只认 exports |
面试考法:"exports 字段解决什么问题""import 和 require 怎么指向不同文件"。答到封装子路径、条件导出双格式、优先级高于 main。
5.4 循环依赖
为什么需要它:A 引用 B、B 又引用 A,是真实项目里常见的结构(工具类互相引用、事件总线与业务模块互引)。不理解加载规则,运行时会拿到空对象还不知道为什么。
核心机制:
- CJS 循环依赖:Node 深度优先加载。A 开始执行 → require B → B 开始执行 → require A → A 正在执行,返回半成品的
module.exports(通常是{})。B 拿到这个{}就继续跑,B 跑完回到 A,A 继续。结果是 B 里用 A 的导出时拿到空对象。 - ESM 循环依赖:live binding。A 开始 → import B(提升)→ B 开始 → import A(拿到 A 的绑定,此时 A 还没执行到导出语句)→ B 执行时如果访问 A 的变量,会拿到
undefined,但等 A 执行完后,binding 是实时的,所以函数声明在 ESM 里通常没事(函数提升),变量会有 TDZ 问题。 - 解决:用依赖倒置——把共用逻辑抽成 C,A 和 B 都依赖 C;或者延迟 require(在函数内部 require,而不是模块顶层)。
最小可运行示例:
// a.js(CJS)
console.log("a 开始");
const b = require("./b");
console.log("a 拿到 b:", b.name);
exports.name = "A";
// b.js
console.log("b 开始");
const a = require("./a");
console.log("b 拿到 a:", a.name);
exports.name = "B";
// 运行 node a.js 输出:
// a 开始
// b 开始
// b 拿到 a: undefined <- a 还没执行到 exports.name
// a 拿到 b: B
// 修法 1:延迟 require
// b.js
function doSomething() {
const a = require("./a"); // 函数执行时才 require,此时 a 已加载完
console.log(a.name);
}
module.exports = { doSomething };
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
循环 require 拿到 {} |
CJS 半成品加载 | 延迟 require,或抽公共模块 |
| ESM 里访问导出变量是 undefined | live binding 还没初始化 | 函数声明优先(提升);变量用函数包装 |
| 单独跑每个文件都正常,合起来报错 | 加载顺序差异 | 从入口文件按真实顺序复现 |
面试考法:"循环依赖怎么产生的,CJS 与 ESM 行为有什么差别"。答到深度优先半成品 vs live binding;CJS 拿到空对象,ESM 函数提升可用、变量 TDZ。
5.5 npm/pnpm/yarn 与依赖提升
为什么需要它:Node 的 node_modules 解析规则要求包在顶层目录可见。npm 用"依赖提升"把所有包平铺到顶层,导致"幽灵依赖"——你没声明的包也能 import。pnpm 用硬链接解决了这个问题。
核心机制:
- npm 与 Yarn Classic:扁平 node_modules。把所有依赖(包括间接依赖)平铺到顶层,同名包不同版本放嵌套目录。问题:你能 import 到没在 package.json 声明的包(幽灵依赖),因为它们被提升到了顶层。
- pnpm:嵌套 + 硬链接。真实包存在
node_modules/.pnpm/,项目里直接依赖的包用硬链接链接到node_modules/,间接依赖不在顶层。你只能 import 声明过的包,幽灵依赖直接报错。 - Yarn Berry(PnP):不用 node_modules,直接解析 zip。
- 依赖提升的代价:版本冲突时 npm 随机选一个提升,可能出现"本地好的、CI 坏的"。
- pnpm 的硬链接节省磁盘:同一版本全局 store 只存一份,多项目共用。
最小可运行示例:
# npm 安装
npm install lodash
# node_modules/lodash 在顶层
# pnpm 安装(幽灵依赖会报错)
pnpm init
pnpm add lodash
# 然后在代码里写 import moment from "moment"(没声明)
# pnpm 报:Cannot find module 'moment'
# npm 不会报错——因为某个间接依赖带了 moment,被提升到顶层
# pnpm 的 node_modules 结构
node_modules/
.pnpm/
lodash@4.17.21/
node_modules/lodash/ <- 真实文件
lodash/ <- 硬链接到 .pnpm/lodash@4.17.21/...
.bin/
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| npm 项目里 import 未声明包成功,pnpm 里失败 | 幽灵依赖 | 在 package.json 里显式声明 |
| pnpm install 后磁盘占用没增加 | 硬链接到全局 store | 正常现象,不是 bug |
| npm 项目本地好、CI 坏 | 依赖提升版本不确定 | 锁版本、改用 pnpm |
EINTEGRITY 校验失败 |
包被篡改或缓存损坏 | 清 ~/.npm 或 ~/.local/share/pnpm/store |
面试考法:"什么是幽灵依赖,pnpm 怎么解决的""硬链接是什么"。答到平铺导致未声明包可见;pnpm 用嵌套+硬链接,只有直接依赖在顶层。
5.6 lock 文件与 npm ci
为什么需要它:lock 文件记录"这次安装时每个包的精确版本与校验和"。没有它,每次 npm install 都可能拉到不同版本,导致构建不可复现。
核心机制:
package-lock.json(npm)/pnpm-lock.yaml(pnpm)/yarn.lock(Yarn):完整依赖树的版本锁定,含传递依赖。npm install:读 lock,但如果 package.json 有新依赖,会更新 lock。npm ci:严格按 lock 安装,不更新 lock。如果 lock 与 package.json 不一致直接报错。CI 环境必须用npm ci。- lock 文件必须提交到 git。删 lock 重装会得到"看似一样但版本已变"的依赖树。
- lock 文件里的
integrity字段是包内容的哈希,防止供应链篡改。
最小可运行示例:
# 本地开发
npm install lodash@4.17.20 # 更新 package.json 与 lock
git add package.json package-lock.json
git commit -m "add lodash 4.17.20"
# CI / 生产构建
npm ci # 严格按 lock,不联网更新
# 等价于:rm -rf node_modules && npm install,但更快且严格
# 错误:删 lock 后重装
rm package-lock.json
npm install
# lodash 可能变成 4.17.21 或更高,版本漂移
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
npm ci 报 "package-lock.json 同步失败" |
package.json 改了但 lock 没更新 | 本地 npm install 更新 lock 再提交 |
| 同事 install 后版本变了 | 没提交 lock | 把 lock 加入 git |
| CI 每次构建版本不同 | 用了 npm install 而非 npm ci |
改 CI 命令为 npm ci |
| lock 文件冲突难以合并 | 多人同时加依赖 | 用 npm install 顺序化,或用 pnpm |
面试考法:"npm install 和 npm ci 的区别""lock 文件要不要提交"。答到 ci 严格复现、不更新 lock;必须提交。
5.7 workspaces/monorepo 与私有 registry
为什么需要它:现代项目常把多个包放在一个仓库(monorepo),共享代码、统一版本。workspaces 让本地包互相引用而不需要发 npm。
核心机制:
package.json的workspaces字段声明子包目录。npm install会自动把子包用软链接链接到node_modules。- 子包之间引用:
"dependencies": { "@my/utils": "*" },npm 会链接到本地packages/utils。 - 私有 registry:团队内部包(如内部组件库)发到 Verdaccio 或 npm Enterprise,用
.npmrc配置 registry 与 token。 npm audit:扫描依赖已知漏洞;npm publish --access public发包;npm version patch升级版本号。- 发包前要配好
exports与files字段(决定哪些文件进 npm 包)。
最小可运行示例:
// 根 package.json
{
"name": "my-monorepo",
"workspaces": ["packages/*"]
}
// packages/utils/package.json
{
"name": "@my/utils",
"version": "1.0.0",
"main": "index.js"
}
// packages/app/package.json
{
"name": "@my/app",
"dependencies": { "@my/utils": "*" }
}
# 根目录安装
npm install
# node_modules/@my/utils 软链接到 packages/utils
# 发私有包
npm publish --registry https://npm.myteam.com
# .npmrc 里配置
# registry=https://npm.myteam.com
# //npm.myteam.com/:_authToken=xxxx
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| workspaces 子包没链接 | workspaces 字段写错 | 看目录是否在声明的 glob 里 |
| 发私有包到公共 npm | registry 没切 | 配 .npmrc 或 publish 时指定 --registry |
| 包里含 node_modules | 没配 files 字段 |
在 package.json 配 "files": ["dist"] |
E404 包不存在 |
registry 或包名错 | 看 .npmrc 与包名 scoped 段 |
面试考法:"monorepo 怎么管理""私有包怎么发"。答到 workspaces 软链接、私有 registry + token。
六、分层练习
6.1 复现型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| CJS 导出陷阱 | 写 module.exports = obj 后 exports.x = 1,看外部能否拿到 x |
观察到 undefined,理解脱钩 | 0.5 小时 |
| ESM 取 __dirname | 在 "type": "module" 项目里用 fileURLToPath 取目录 |
输出正确路径 | 0.5 小时 |
| 循环依赖复现 | 写 A↔B 互相 require,观察 B 里拿到的 A 是半成品 | 复现 {} 现象 |
1 小时 |
| pnpm 幽灵依赖 | 在 pnpm 项目里 import 一个未声明包 | 看到 cannot find module | 0.5 小时 |
| npm ci 复现 | 删 node_modules 与 lock,用 npm install 再 npm ci |
ci 严格复现 | 0.5 小时 |
6.2 改造型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 修导出丢失 | 给定 module.exports 与 exports 混用代码,改成统一写法 | 外部能拿到所有导出 | 0.5 小时 |
| 修循环依赖 | 给定 A↔B 半成品,用延迟 require 或抽 C 修掉 | 运行时不再 undefined | 1.5 小时 |
| CJS 项目转 ESM | 给定 CJS 项目,加 "type": "module" 并修所有 require |
用 import 跑通,无报错 | 1.5 小时 |
| 加 exports 字段 | 给定一个包,加条件导出区分 import/require | Node 端两种用法都通 | 1 小时 |
| 幽灵依赖显式声明 | pnpm 报错的包,在 package.json 里补上声明 | pnpm install 成功 | 0.5 小时 |
6.3 设计型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| pnpm workspace 双包 | 建 packages/utils 与 packages/app,app 引用 utils |
pnpm install 后软链接生效,app 能调 utils |
3 小时 |
| 双格式包 | 发一个包,exports 区分 import/require,CJS 与 ESM 项目都能用 | 两端 import 成功 | 4 小时 |
| 依赖审计流程 | 跑 npm audit,修一个中危漏洞,提交 lock |
audit 报告无该漏洞 | 2 小时 |
| 私有 registry 配置 | 写 .npmrc 模板,说明 token 与 registry 配置 |
能在团队文档里复用 | 1 小时 |
七、排障表
| 现象 | 可能原因 | 排查步骤 | 解决办法 |
|---|---|---|---|
require is not defined |
ESM 文件里用了 require | 看文件顶部是否 "type": "module" |
改 import,或用 createRequire |
Cannot use import statement outside a module |
CJS 文件里写了 import | 看 type 字段 | 改成 require,或加 "type": "module" |
ERR_REQUIRE_ESM |
CJS 里 require 了 ESM 包 | 看包 package.json type | 改用动态 await import() |
| 导出的属性 undefined | exports 与 module.exports 脱钩 | 看是否先整体赋值 | 统一只往 exports 加属性 |
循环 require 拿到 {} |
CJS 半成品加载 | 画依赖图 | 延迟 require,或抽公共模块 |
ERR_PACKAGE_PATH_NOT_EXPORTED |
子路径没在 exports 声明 | 看包 exports 字段 | 加映射,或换包名 |
| pnpm 里 import 未声明包报错 | 幽灵依赖 | 看 package.json dependencies | 显式声明该包 |
npm ci 报 lock 不同步 |
package.json 改了 lock 没更新 | diff package.json 与 lock | 本地 npm install 更新 lock 再提交 |
八、出口条件
全部勾选后再进入 阶段 3 TypeScript 工程化。
- [ ] 能说清
module.exports与exports的关系,修掉导出丢失 bug - [ ] 能在 ESM 项目里用
fileURLToPath(import.meta.url)取目录 - [ ] 能解释 CJS 循环依赖为什么拿到
{},并用延迟 require 修掉 - [ ] 能写
exports条件导出,区分 import 与 require 入口 - [ ] 能用 pnpm workspace 建两个互相引用的本地包
- [ ] 能说清
npm install与npm ci的区别,CI 用 ci - [ ] 能解释幽灵依赖与硬链接,说明 pnpm 为何阻止未声明包
- [ ] 排障表八个现象,随机抽三个能在 5 分钟内给出排查路径
自测题:
module.exports = foo后再exports.bar = 1,外部require拿到什么?- 要点:拿到
foo,没有bar。因为重新赋值后 exports 与新对象脱钩。
- 要点:拿到
- ESM 里没有
__dirname,怎么取?- 要点:
fileURLToPath(import.meta.url)得到__filename,再dirname得到目录。
- 要点:
- CJS 循环依赖时为什么拿到
{}?ESM 行为有什么不同?- 要点:CJS 深度优先,A 加载到 require B 时返回半成品 exports;ESM live binding,函数提升可用,变量 TDZ 时为 undefined。
package.json的exports字段与main谁优先?- 要点:exports 优先。有 exports 时 main 被忽略。
- 什么是幽灵依赖?pnpm 怎么阻止?
- 要点:npm 平铺导致未声明包也能 import;pnpm 嵌套+硬链接,只有直接依赖在顶层。
npm ci与npm install关键区别?- 要点:ci 严格按 lock 安装、不更新、不一致直接报错;install 会读 lock 但允许更新。
ERR_REQUIRE_ESM怎么产生?- 要点:CJS 文件用 require 加载了一个
"type": "module"的包。改用动态await import()。
- 要点:CJS 文件用 require 加载了一个