罗罗编程学习记录
本页内容 展开查看

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 与打包工具提供兼容层,但行为有差异。

原理流程

  1. 解析模块图时 ESM 静态确定依赖。
  2. CJS 在调用 require 时才加载模块。
  3. 打包工具按规范选择静态分析与优化策略。

代码 / 示例

// 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:函数表达式立即执行,形成闭包作用域。

原理流程

  1. 库需要多环境兼容时输出 UMD。
  2. AMD 按依赖声明异步加载。
  3. 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:构建、测试、发布命令。

原理流程

  1. 安装时按依赖字段解析包。
  2. 打包工具按入口字段定位模块。
  3. 类型检查按 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、测试、类型工具。
  • 对等依赖:库不打包宿主,由使用者提供。

原理流程

  1. 区分代码运行与开发工具用途。
  2. 运行时进入 dependencies。
  3. 宿主兼容版本声明为 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。
  • 次版本:向后兼容新功能。
  • 补丁:向后兼容修复。

原理流程

  1. 声明版本范围与前缀。
  2. 安装时解析范围内最新兼容版本。
  3. 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 应纳入版本管理。

原理流程

  1. 首次安装生成 lockfile。
  2. 后续安装优先按 lockfile 解析。
  3. 升级依赖时更新 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 限制幽灵依赖访问。

原理流程

  1. 选择包管理器并锁定版本。
  2. 安装依赖生成对应 lockfile。
  3. 项目内脚本统一通过该工具执行。

代码 / 示例

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:内部包以协议/目录互相引用。
  • 共享:统一依赖版本、脚本与规范。
  • 边界:包职责单一,避免循环依赖。

原理流程

  1. 仓库根配置 workspace 清单。
  2. 各包声明 package.json 与入口。
  3. 内部包通过 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 存在后封闭私有路径。

原理流程

  1. 使用者导入包路径。
  2. 打包/解析工具按条件匹配 exports 映射。
  3. 命中文件作为模块入口,未声明路径拒绝解析。

代码 / 示例

{
  "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 声明、只是被提升上来的间接依赖,声明缺失时换包管理器或升级后可能断裂。

概念解释

  • 提升:减少重复副本,便于顶层解析。
  • 幽灵依赖:未声明却可用的间接依赖。
  • 风险:解析结构变化后引用失效。

原理流程

  1. 安装时依赖树扁平化提升。
  2. 顶层出现间接依赖供解析。
  3. 代码误用未声明依赖形成幽灵依赖。

代码 / 示例

项目依赖 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 执行产物需要。
  • 开发期:构建、检查、测试环节使用。
  • 类型:编译期擦除,不进入运行产物。

原理流程

  1. 梳理源码 import 的外部包。
  2. 运行时引用进 dependencies。
  3. 工具与类型声明进 devDependencies。

代码 / 示例

dependencies:框架、工具函数库、运行时样式
devDependencies:构建器、测试框架、ESLint、TS 类型包

常见误区

  • 误区:所有依赖都放 dependencies 最省事;正解:开发依赖会污染运行时安装与产物分析。
  • 误区:类型包需要运行时安装;正解:类型在编译期擦除,归开发依赖。

追问

  • Q:UI 组件库的样式文件算运行时吗? A:产物加载需要则归 dependencies,构建期注入工具另算开发依赖。
  • Q:如何排查误分类? A:分析产物 import 与构建工具引用清单对照 package.json。

03.6.1.1-012 重复依赖与版本对齐如何处理?

一句话结论

同一包被多版本引用时 node_modules 保留多份副本;通过对齐版本范围、升级公共依赖、检查重复打包分析减少冗余,避免同一库多份进入产物。

概念解释

  • 多版本并存:依赖范围冲突无法提升。
  • 重复打包:同一库多份进入 bundle。
  • 对齐:统一版本范围减少副本。

原理流程

  1. 分析产物与 node_modules 中的重复版本。
  2. 对齐可统一的依赖范围。
  3. 必要时配置别名/分包排除重复。

代码 / 示例

分析:bundle 中同一库出现多份
处理:对齐版本 → 升级冲突依赖 → 分包/externals

常见误区

  • 误区:只要 package.json 写了版本就不会重复;正解:嵌套依赖范围冲突仍会保留多份。
  • 误区:重复依赖一定是项目直接依赖导致;正解:间接依赖锁定的版本冲突也会产生副本。

追问

  • Q:如何查看重复依赖? A:产物分析工具与安装树命令列出多版本副本,具体命令按包管理器确认。
  • Q:同一库多份对体积影响多大? A:需结合库体积与副本数量评估,优先对齐高频大包。

03.6.1.1-013 安装脚本与供应链安全需要注意什么?

一句话结论

依赖安装与发布脚本可能执行任意代码,需锁定可信来源、审查包维护状态、定期审计漏洞、避免安装未知来源包;CI 中使用锁定版本并检查完整性校验。

概念解释

  • 生命周期脚本:install/postinstall 等。
  • 漏洞:已知安全公告与弃用包。
  • 来源:registry 与包名仿冒风险。

原理流程

  1. 安装前核对包名与维护方。
  2. 定期审计已知漏洞与弃用状态。
  3. 锁定版本与完整性校验,限制脚本执行。

代码 / 示例

安全实践:
  锁定 lockfile 版本
  审计已知漏洞与弃用包
  核对包名拼写与发布者
  按需要限制生命周期脚本执行

常见误区

  • 误区:npm 官方 registry 上的包一定可信;正解:仍存在仿冒与维护中断风险,需审计。
  • 误区:安装脚本无关紧要;正解:postinstall 可在安装期执行代码,属于供应链攻击面。

追问

  • Q:依赖审计命令有哪些? A:各包管理器提供 audit 子命令,输出漏洞与修复建议,具体输出按版本确认。
  • Q:私有包如何管理来源? A:配置私有 registry 与认证,隔离公共与内部包。

03.6.1.1-014 私有包与 registry 如何配置?

一句话结论

内部私有包配置私有 registry 地址与认证凭证,按作用域(scope)区分公共与私有来源;凭证通过环境变量或本地认证配置注入,不写入仓库源码。

概念解释

  • registry:包下载/发布地址。
  • scope:@scope 前缀映射不同 registry。
  • 认证:令牌/凭证按环境注入。

原理流程

  1. 配置 registry 与 scope 映射。
  2. 安装/发布携带认证信息。
  3. 凭证不提交到仓库。

代码 / 示例

.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:建立链接让项目解析到本地包。
  • 联动:源码修改后需重新构建或配置热更新。

原理流程

  1. 内部包构建产物可被项目解析。
  2. 用 workspace 或 link 关联本地目录。
  3. 修改包后重新构建并在项目验证。

代码 / 示例

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 分层更新:先更新补丁与安全公告,回归测试后再升次版本;主版本升级先读迁移指南,在分支小步升级并验证产物与类型。

概念解释

  • 分层:补丁 → 次版本 → 主版本。
  • 回归:更新后跑类型检查、测试与构建。
  • 节奏:定期批量更新而非长期停滞。

原理流程

  1. 审计当前版本与已知漏洞。
  2. 分批更新并跑测试构建。
  3. 主版本阅读迁移指南后小步升级。

代码 / 示例

更新节奏:
  安全补丁:及时更新
  次版本:定期批量升级 + 回归
  主版本:读迁移指南,分支验证后合并

常见误区

  • 误区:依赖长期不更新最稳定;正解:停滞会累积漏洞与兼容债务。
  • 误区:一次性跨多个主版本升级;正解:逐版本迁移降低定位成本。

追问

  • Q:如何评估升级风险? A:看变更日志、breaking 列表、测试覆盖与产物分析。
  • Q:升级后类型报错如何处理? A:按类型文档调整用法,必要时锁定兼容版本。

03.6.1.1-017 浏览器端模块加载与打包是什么关系?

一句话结论

浏览器原生可通过 ESM 加载模块,但生产环境需打包合并、转译与压缩以减少请求数、兼容旧环境;开发环境可利用原生 ESM 按需编译加快启动,生产构建再做完整优化。

概念解释

  • 原生 ESM:浏览器直接解析模块图。
  • 打包:合并产物、转译语法、压缩与分包。
  • 环境差异:开发重启动速度,生产重体积与兼容。

原理流程

  1. 开发环境按需编译原生模块。
  2. 生产构建打包成优化产物。
  3. 浏览器加载打包后的脚本/模块。

代码 / 示例

开发:原生 ESM + 按需编译
生产:打包分包 + 转译 + 压缩 + 静态资源优化

常见误区

  • 误区:浏览器能跑 ESM 就不需要打包;正解:未打包产物请求多、语法与兼容需处理。
  • 误区:开发与生产构建配置应完全一致;正解:两者目标不同,分别优化启动速度与产物体积。

追问

  • Q:打包如何识别浏览器兼容目标? A:browserslist 配置结合转译工具决定语法降级范围。
  • Q:模块脚本有什么加载限制? A:type="module" 默认延迟执行且受 CORS 约束,具体行为按浏览器版本确认。

03.6.1.1-018 模块与依赖管理有哪些版本边界需要标注待确认?

一句话结论

包管理器命令、workspace 协议、exports 条件、peer 安装策略与锁文件格式随版本演进;涉及具体默认行为与支持范围的结论标注待确认,对照项目版本与官方文档验证。

概念解释

  • 版本差异:命令改名、默认值调整、格式变更。
  • 规范演进:ESM 条件与 Node 解析规则更新。
  • 验证:版本号 + 文档 + 最小复现。

原理流程

  1. 记录包管理器与 Node 版本。
  2. 对照文档核对字段与命令行为。
  3. 最小样例验证后写入结论。

代码 / 示例

待确认项:
- peerDependencies 自动安装策略
- exports 条件名与解析顺序
- workspace 协议与 link 行为
验证点:版本号 + 官方文档 + 最小复现样例

常见误区

  • 误区:依赖管理结论跨工具通用;正解:npm/pnpm/yarn 策略与结构不同。
  • 误区:教程配置适用于当前版本;正解:升级后字段默认值可能变化。

追问

  • Q:如何确认工具版本? A:读 packageManager 字段、lockfile 版本与实际安装版本。
  • Q:升级包管理器回归哪些项? A:安装确定性、workspace 关联与产物解析。