03.6.1.1 模块规范与依赖管理
所属:全栈开发面试题库 / 03 前端基础与 Web 开发 / 03.6 前端工程化 / 03.6.1 工程化与构建
03.6.1.1-001 ESM 与 CJS 有什么区别?
一句话结论
ESM 是浏览器与现代 Node 通用的静态模块规范,编译期可分析导入导出、支持活绑定与 tree-shaking;CJS 是 Node 早期规范,运行时 require 动态加载、导出值拷贝,静态分析能力弱。
概念解释
- ESM:
import/export,顶层静态结构,活绑定。 - CJS:
require/module.exports,运行时加载,导出快照拷贝。 - 互操作:现代 Node 与打包工具提供兼容层,但行为有差异。
原理流程
- 解析模块图时 ESM 静态确定依赖。
- CJS 在调用 require 时才加载模块。
- 打包工具按规范选择静态分析与优化策略。
代码 / 示例
// ESM
export const name = "ann";
import { name } from "./mod.js";
// CJS
const mod = require("./mod");
module.exports = { name: "ann" };
常见误区
- 误区:ESM 导出的是值拷贝;正解:ESM 是活绑定,导出值变化导入侧可见。
- 误区:CJS 也能被 tree-shaking;正解:运行时动态 require 难以静态分析,摇除效果差。
追问
- Q:ESM 顶层
this是什么? A:为 undefined,与 CJS 顶层this指向 module.exports 不同。 - Q:浏览器原生支持 ESM 吗? A:通过
<script type="module">加载,旧浏览器需打包转译。
03.6.1.1-002 UMD、AMD、IIFE 分别解决什么问题?
一句话结论
UMD 兼容 CJS/AMD/全局等多种环境,用于打包产物在不同加载方式下可用;AMD 是浏览器早期异步模块规范(RequireJS);IIFE 立即执行函数把代码包裹为私有作用域,避免全局污染。
概念解释
- UMD:产物同时支持模块加载器与全局挂载。
- AMD:浏览器异步依赖加载规范。
- IIFE:函数表达式立即执行,形成闭包作用域。
原理流程
- 库需要多环境兼容时输出 UMD。
- AMD 按依赖声明异步加载。
- IIFE 包裹变量避免泄漏到全局。
代码 / 示例
// IIFE 作用域
(function () {
const privateValue = 1;
// 对外暴露挂载到全局
})();
常见误区
- 误区:现代前端仍需手写 AMD;正解:构建工具按目标环境输出格式,AMD 已基本退出日常开发。
- 误区:UMD 产物体积最小;正解:兼容判断代码有额外开销,现代库优先 ESM/CJS。
追问
- Q:什么场景还会见到 UMD? A:老旧项目、CDN 直接引入的第三方产物。
- Q:IIFE 与模块作用域区别? A:IIFE 是手写闭包隔离,模块由打包/运行时提供作用域。
03.6.1.1-003 package.json 有哪些关键字段?
一句话结论
name/version 标识包,main/module/types/exports 指向入口与类型,scripts 定义命令,dependencies/devDependencies/peerDependencies 声明依赖关系;字段决定打包解析、类型查找与安装行为。
概念解释
- 入口:main(CJS)、module(ESM)、types(类型声明)。
- exports:条件导出与子路径映射。
- scripts:构建、测试、发布命令。
原理流程
- 安装时按依赖字段解析包。
- 打包工具按入口字段定位模块。
- 类型检查按 types/exports 查找声明。
代码 / 示例
{
"name": "ui-kit",
"version": "1.2.0",
"main": "dist/index.cjs",
"module": "dist/index.mjs",
"types": "dist/index.d.ts",
"exports": {
".": { "types": "./dist/index.d.ts", "import": "./dist/index.mjs", "require": "./dist/index.cjs" }
},
"scripts": { "build": "vite build", "test": "vitest" }
}
常见误区
- 误区:exports 与 main 可以随意混用;正解:配置 exports 后子路径解析以 exports 为准,main 仅作兼容。
- 误区:types 字段可有可无;正解:库项目不提供类型声明会影响使用者类型检查。
追问
- Q:module 字段被什么工具使用? A:打包工具优先解析 ESM 入口以支持 tree-shaking,具体解析顺序按工具版本确认。
- Q:scripts 中 pre/post 钩子如何执行? A:npm/pnpm 约定 pre 与 post 前缀自动串联,具体行为按包管理器版本确认。
03.6.1.1-004 dependencies、devDependencies、peerDependencies 有何区别?
一句话结论
dependencies 是运行时必需依赖,devDependencies 是开发构建/测试工具,peerDependencies 声明宿主环境应提供的兼容版本(如组件库对 React 的要求);optionalDependencies 缺失时不阻断安装。
概念解释
- 运行时依赖:产物代码执行需要。
- 开发依赖:构建、lint、测试、类型工具。
- 对等依赖:库不打包宿主,由使用者提供。
原理流程
- 区分代码运行与开发工具用途。
- 运行时进入 dependencies。
- 宿主兼容版本声明为 peerDependencies。
代码 / 示例
{
"dependencies": { "lodash-es": "^4.17.21" },
"devDependencies": { "vite": "^5.0.0", "vitest": "^2.0.0" },
"peerDependencies": { "react": ">=18.0.0" }
}
常见误区
- 误区:构建工具放进 dependencies 无所谓;正解:开发依赖混入运行时会增大安装与打包误引入风险。
- 误区:peerDependencies 会自动安装;正解:对等依赖由宿主提供,安装策略随包管理器版本变化。
追问
- Q:peerDependenciesMeta 做什么? A:标记对等依赖为可选或补充安装提示,具体字段按包管理器版本确认。
- Q:类型声明包放哪类? A:通常作为 devDependencies,除非库运行时需要类型运行时产物。
03.6.1.1-005 semver 版本规范与 ^、~ 行为是什么?
一句话结论
语义化版本 主版本.次版本.补丁:主版本含不兼容变更,次版本新增功能兼容,补丁修复缺陷;^ 允许次版本与补丁升级,~ 只允许补丁升级,锁定版本由 lockfile 保证确定性安装。
概念解释
- 主版本:breaking change。
- 次版本:向后兼容新功能。
- 补丁:向后兼容修复。
原理流程
- 声明版本范围与前缀。
- 安装时解析范围内最新兼容版本。
- lockfile 记录实际安装版本。
代码 / 示例
^1.2.3 → 1.x.x 内最新(不进 2.x)
~1.2.3 → 1.2.x 内最新(不进 1.3)
1.2.3 → 精确锁定
常见误区
- 误区:
^会升到下一个主版本;正解:主版本不允许跨越。 - 误区:锁版本只看 package.json;正解:实际安装版本以 lockfile 为准。
追问
- Q:0.x 版本的
^行为特殊吗? A:0.x 次版本视为不兼容,^0.x.y只允许补丁升级,具体按 semver 规范确认。 - Q:预发布版本如何处理? A:需显式指定 tag 或范围,稳定范围不自动包含预发布。
03.6.1.1-006 lockfile 解决什么问题?
一句话结论
lockfile 记录每个依赖的精确版本与解析地址,保证不同机器、不同时间安装得到相同依赖树;没有 lockfile 时范围版本可能解析到不同版本,产生环境差异。
概念解释
- 确定性:安装结果可复现。
- 依赖树:含嵌套依赖版本与完整性校验。
- 提交:lockfile 应纳入版本管理。
原理流程
- 首次安装生成 lockfile。
- 后续安装优先按 lockfile 解析。
- 升级依赖时更新 lockfile 并提交。
代码 / 示例
package-lock.json / pnpm-lock.yaml / yarn.lock
记录:精确版本、依赖树、完整性 hash
常见误区
- 误区:lockfile 可以加入 .gitignore;正解:提交 lockfile 才能保证团队与 CI 安装一致。
- 误区:改 package.json 范围后 lockfile 自动同步;正解:需重新安装更新 lockfile。
追问
- Q:lockfile 与 node_modules 区别? A:lockfile 记录版本树,node_modules 是实际落盘文件。
- Q:CI 安装需要 lockfile 吗? A:需要,按 lockfile 确定性安装避免漂移。
03.6.1.1-007 npm、pnpm、yarn 的依赖管理有何差异?
一句话结论
npm 是官方基础工具,pnpm 用全局内容寻址存储与硬链接节省磁盘、严格隔离依赖,yarn historically 强调离线缓存与工作区;三者命令与 workspace 能力不同,node_modules 结构也有差异。
概念解释
- 扁平提升:传统 npm/yarn 把依赖提升到顶层。
- 内容寻址:pnpm 全局存储硬链接复用。
- 严格隔离:pnpm 限制幽灵依赖访问。
原理流程
- 选择包管理器并锁定版本。
- 安装依赖生成对应 lockfile。
- 项目内脚本统一通过该工具执行。
代码 / 示例
npm → package-lock.json,扁平 node_modules
pnpm → pnpm-lock.yaml,全局 store + 硬链接,严格依赖
yarn → yarn.lock,离线缓存与 workspace
常见误区
- 误区:三个工具 lockfile 可互换;正解:项目应固定一种包管理器,混用 lockfile 会冲突。
- 误区:pnpm 严格隔离会导致所有旧项目报错;正解:幽灵依赖需补全声明,行为差异按版本确认。
追问
- Q:项目如何锁定包管理器版本? A:通过 packageManager 字段或核心文件配置,具体字段按工具版本确认。
- Q:node_modules 为什么有嵌套副本? A:版本冲突时不同版本不能提升到同一目录,保留嵌套副本。
03.6.1.1-008 Monorepo 如何组织包与工作区?
一句话结论
Monorepo 把多个相关包放在同一仓库,workspace 声明内部包互相引用,共享依赖与构建配置;按业务域划分包边界,配合增量构建与缓存减少重复工作量。
概念解释
- workspace:内部包以协议/目录互相引用。
- 共享:统一依赖版本、脚本与规范。
- 边界:包职责单一,避免循环依赖。
原理流程
- 仓库根配置 workspace 清单。
- 各包声明 package.json 与入口。
- 内部包通过 workspace 协议引用。
代码 / 示例
// 根 package.json
{
"workspaces": ["packages/*", "apps/*"]
}
// 内部包引用
{
"dependencies": { "@scope/utils": "workspace:*" }
}
常见误区
- 误区:Monorepo 内包可以任意互相引用;正解:需维护包边界与依赖方向,避免循环依赖。
- 误区:Monorepo 自动解决版本冲突;正解:仍需对齐共享依赖版本。
追问
- Q:Monorepo 常用工具? A:pnpm workspace、Turborepo、Nx、Lerna 等,能力按版本确认。
- Q:如何只构建受影响包? A:依赖图分析 + 增量缓存,按变更范围执行任务。
03.6.1.1-009 exports 条件导出与子路径导出如何工作?
一句话结论
exports 按条件(import/require/types/开发环境)映射入口文件,并限制子路径访问;比 main/module 更精确,可区分 ESM/CJS/类型声明入口,未声明的子路径不能被引用。
概念解释
- 条件字段:import、require、types、development 等。
- 子路径:
./*通配映射。 - 限制:exports 存在后封闭私有路径。
原理流程
- 使用者导入包路径。
- 打包/解析工具按条件匹配 exports 映射。
- 命中文件作为模块入口,未声明路径拒绝解析。
代码 / 示例
{
"exports": {
".": "./dist/index.mjs",
"./theme": "./dist/theme.mjs",
"./*": "./dist/*.mjs"
}
}
常见误区
- 误区:配置 exports 后 main 仍可被任意读取;正解:exports 封闭未映射子路径,main 仅兼容遗留解析。
- 误区:types 条件可以省略;正解:库项目需在 exports 中映射类型声明,否则类型查找失败。
追问
- Q:exports 与浏览器/Node 条件如何区分? A:按环境条件字段映射对应产物,具体条件名规范按 Node/打包工具版本确认。
- Q:子路径通配如何避免泄露私有文件? A:只映射公开目录,私有目录不进入通配范围。
03.6.1.1-010 什么是依赖提升与幽灵依赖?
一句话结论
扁平提升把嵌套依赖提升到顶层 node_modules 便于解析;幽灵依赖指代码直接引用了未在 package.json 声明、只是被提升上来的间接依赖,声明缺失时换包管理器或升级后可能断裂。
概念解释
- 提升:减少重复副本,便于顶层解析。
- 幽灵依赖:未声明却可用的间接依赖。
- 风险:解析结构变化后引用失效。
原理流程
- 安装时依赖树扁平化提升。
- 顶层出现间接依赖供解析。
- 代码误用未声明依赖形成幽灵依赖。
代码 / 示例
项目依赖 A,A 依赖 B
项目代码直接 import B,但未在 package.json 声明 B
→ 幽灵依赖,pnpm 严格隔离下不可访问
常见误区
- 误区:能 import 就说明依赖已正确声明;正解:可用可能来自提升,必须核对 package.json。
- 误区:幽灵依赖在所有工具下行为一致;正解:不同工具提升与隔离策略不同。
追问
- Q:如何消除幽灵依赖? A:把实际引用的间接依赖补进 dependencies/devDependencies。
- Q:为什么 pnpm 更容易暴露这个问题? A:严格隔离不提升幽灵依赖到项目可访问范围。
03.6.1.1-011 运行时依赖与开发/类型依赖如何区分?
一句话结论
产物代码执行时引用的包放 dependencies,构建转译、lint、测试、类型工具放 devDependencies;类型声明包一般归开发依赖,避免把工具链打入运行时安装。
概念解释
- 运行时:浏览器/Node 执行产物需要。
- 开发期:构建、检查、测试环节使用。
- 类型:编译期擦除,不进入运行产物。
原理流程
- 梳理源码 import 的外部包。
- 运行时引用进 dependencies。
- 工具与类型声明进 devDependencies。
代码 / 示例
dependencies:框架、工具函数库、运行时样式
devDependencies:构建器、测试框架、ESLint、TS 类型包
常见误区
- 误区:所有依赖都放 dependencies 最省事;正解:开发依赖会污染运行时安装与产物分析。
- 误区:类型包需要运行时安装;正解:类型在编译期擦除,归开发依赖。
追问
- Q:UI 组件库的样式文件算运行时吗? A:产物加载需要则归 dependencies,构建期注入工具另算开发依赖。
- Q:如何排查误分类? A:分析产物 import 与构建工具引用清单对照 package.json。
03.6.1.1-012 重复依赖与版本对齐如何处理?
一句话结论
同一包被多版本引用时 node_modules 保留多份副本;通过对齐版本范围、升级公共依赖、检查重复打包分析减少冗余,避免同一库多份进入产物。
概念解释
- 多版本并存:依赖范围冲突无法提升。
- 重复打包:同一库多份进入 bundle。
- 对齐:统一版本范围减少副本。
原理流程
- 分析产物与 node_modules 中的重复版本。
- 对齐可统一的依赖范围。
- 必要时配置别名/分包排除重复。
代码 / 示例
分析:bundle 中同一库出现多份
处理:对齐版本 → 升级冲突依赖 → 分包/externals
常见误区
- 误区:只要 package.json 写了版本就不会重复;正解:嵌套依赖范围冲突仍会保留多份。
- 误区:重复依赖一定是项目直接依赖导致;正解:间接依赖锁定的版本冲突也会产生副本。
追问
- Q:如何查看重复依赖? A:产物分析工具与安装树命令列出多版本副本,具体命令按包管理器确认。
- Q:同一库多份对体积影响多大? A:需结合库体积与副本数量评估,优先对齐高频大包。
03.6.1.1-013 安装脚本与供应链安全需要注意什么?
一句话结论
依赖安装与发布脚本可能执行任意代码,需锁定可信来源、审查包维护状态、定期审计漏洞、避免安装未知来源包;CI 中使用锁定版本并检查完整性校验。
概念解释
- 生命周期脚本:install/postinstall 等。
- 漏洞:已知安全公告与弃用包。
- 来源:registry 与包名仿冒风险。
原理流程
- 安装前核对包名与维护方。
- 定期审计已知漏洞与弃用状态。
- 锁定版本与完整性校验,限制脚本执行。
代码 / 示例
安全实践:
锁定 lockfile 版本
审计已知漏洞与弃用包
核对包名拼写与发布者
按需要限制生命周期脚本执行
常见误区
- 误区:npm 官方 registry 上的包一定可信;正解:仍存在仿冒与维护中断风险,需审计。
- 误区:安装脚本无关紧要;正解:postinstall 可在安装期执行代码,属于供应链攻击面。
追问
- Q:依赖审计命令有哪些? A:各包管理器提供 audit 子命令,输出漏洞与修复建议,具体输出按版本确认。
- Q:私有包如何管理来源? A:配置私有 registry 与认证,隔离公共与内部包。
03.6.1.1-014 私有包与 registry 如何配置?
一句话结论
内部私有包配置私有 registry 地址与认证凭证,按作用域(scope)区分公共与私有来源;凭证通过环境变量或本地认证配置注入,不写入仓库源码。
概念解释
- registry:包下载/发布地址。
- scope:
@scope前缀映射不同 registry。 - 认证:令牌/凭证按环境注入。
原理流程
- 配置 registry 与 scope 映射。
- 安装/发布携带认证信息。
- 凭证不提交到仓库。
代码 / 示例
.npmrc 思路(凭证用环境变量注入):
@scope:registry=https://internal-registry.example.com
//internal-registry/:_authToken=${NPM_TOKEN}
常见误区
- 误区:认证令牌写入项目配置提交;正解:凭证走环境变量或本地/CI 密钥管理。
- 误区:私有包与公共包混用同一 registry 无需区分;正解:按 scope 隔离来源避免误拉取。
追问
- Q:发布私有包需要什么配置? A:登录认证 + registry 指向 + 包名 scope,具体按 registry 平台文档确认。
- Q:CI 中如何注入令牌? A:使用 CI 密钥变量,安装时读取环境变量。
03.6.1.1-015 本地包链接开发如何实现?
一句话结论
本地开发内部包可用 workspace 协议关联本地目录,或用 link 命令把本地包链接到项目 node_modules;修改内部包后重新构建/热更新,调试完成再发布版本。
概念解释
- workspace:包管理器工作区直接引用本地目录。
- link:建立链接让项目解析到本地包。
- 联动:源码修改后需重新构建或配置热更新。
原理流程
- 内部包构建产物可被项目解析。
- 用 workspace 或 link 关联本地目录。
- 修改包后重新构建并在项目验证。
代码 / 示例
workspace:"@scope/utils": "workspace:*"
link:在包目录 link,项目 link 该包
常见误区
- 误区:link 后源码改动实时生效;正解:若引用构建产物,需重新构建包;源码映射配置按工具确认。
- 误区:长期 link 替代版本发布;正解:联调完成后应发布版本并切换回版本依赖。
追问
- Q:link 导致多份 React 实例怎么办? A:对齐依赖或配置别名排除重复实例。
- Q:workspace 与 link 区别? A:workspace 是声明式工作区关联,link 是命令式链接操作。
03.6.1.1-016 依赖更新与升级策略如何制定?
一句话结论
按安全补丁、兼容次版本、主版本 breaking 分层更新:先更新补丁与安全公告,回归测试后再升次版本;主版本升级先读迁移指南,在分支小步升级并验证产物与类型。
概念解释
- 分层:补丁 → 次版本 → 主版本。
- 回归:更新后跑类型检查、测试与构建。
- 节奏:定期批量更新而非长期停滞。
原理流程
- 审计当前版本与已知漏洞。
- 分批更新并跑测试构建。
- 主版本阅读迁移指南后小步升级。
代码 / 示例
更新节奏:
安全补丁:及时更新
次版本:定期批量升级 + 回归
主版本:读迁移指南,分支验证后合并
常见误区
- 误区:依赖长期不更新最稳定;正解:停滞会累积漏洞与兼容债务。
- 误区:一次性跨多个主版本升级;正解:逐版本迁移降低定位成本。
追问
- Q:如何评估升级风险? A:看变更日志、breaking 列表、测试覆盖与产物分析。
- Q:升级后类型报错如何处理? A:按类型文档调整用法,必要时锁定兼容版本。
03.6.1.1-017 浏览器端模块加载与打包是什么关系?
一句话结论
浏览器原生可通过 ESM 加载模块,但生产环境需打包合并、转译与压缩以减少请求数、兼容旧环境;开发环境可利用原生 ESM 按需编译加快启动,生产构建再做完整优化。
概念解释
- 原生 ESM:浏览器直接解析模块图。
- 打包:合并产物、转译语法、压缩与分包。
- 环境差异:开发重启动速度,生产重体积与兼容。
原理流程
- 开发环境按需编译原生模块。
- 生产构建打包成优化产物。
- 浏览器加载打包后的脚本/模块。
代码 / 示例
开发:原生 ESM + 按需编译
生产:打包分包 + 转译 + 压缩 + 静态资源优化
常见误区
- 误区:浏览器能跑 ESM 就不需要打包;正解:未打包产物请求多、语法与兼容需处理。
- 误区:开发与生产构建配置应完全一致;正解:两者目标不同,分别优化启动速度与产物体积。
追问
- Q:打包如何识别浏览器兼容目标? A:browserslist 配置结合转译工具决定语法降级范围。
- Q:模块脚本有什么加载限制? A:type="module" 默认延迟执行且受 CORS 约束,具体行为按浏览器版本确认。
03.6.1.1-018 模块与依赖管理有哪些版本边界需要标注待确认?
一句话结论
包管理器命令、workspace 协议、exports 条件、peer 安装策略与锁文件格式随版本演进;涉及具体默认行为与支持范围的结论标注待确认,对照项目版本与官方文档验证。
概念解释
- 版本差异:命令改名、默认值调整、格式变更。
- 规范演进:ESM 条件与 Node 解析规则更新。
- 验证:版本号 + 文档 + 最小复现。
原理流程
- 记录包管理器与 Node 版本。
- 对照文档核对字段与命令行为。
- 最小样例验证后写入结论。
代码 / 示例
待确认项:
- peerDependencies 自动安装策略
- exports 条件名与解析顺序
- workspace 协议与 link 行为
验证点:版本号 + 官方文档 + 最小复现样例
常见误区
- 误区:依赖管理结论跨工具通用;正解:npm/pnpm/yarn 策略与结构不同。
- 误区:教程配置适用于当前版本;正解:升级后字段默认值可能变化。
追问
- Q:如何确认工具版本? A:读 packageManager 字段、lockfile 版本与实际安装版本。
- Q:升级包管理器回归哪些项? A:安装确定性、workspace 关联与产物解析。