第 2 卷
• 缓存复用无冗余下载:由于全局共享存储的存在,当某个包已被其他项目安装过(相同版本),后
• 无依赖冗余解析:pnpm 的非扁平依赖结构,无需像 npm/yarn 那样进行“依赖提升”和“冲突解
决”的复杂逻辑,解析依赖树的速度更快;同时,pnpm 采用并行安装机制,同时下载多个依赖包,进一步提升安装效率。
• 无需复制文件:传统包管理工具(npm/yarn/cnpm)安装时,会将包从缓存复制到项目
node_modules,而 pnpm 仅通过链接关联,无需执行文件复制操作,这是其安装速度远超其他工具的重要原因。
四、Webpack 基本工作原理与打包过程
- Webpack 基本工作原理
Webpack 是一个静态模块打包器(static module bundler),其核心工作原理是:在项目中,将所有资源(JavaScript、CSS、图片、字体等)都视为模块,通过入口文件(entry)递归解析所有模块
之间的依赖关系,然后通过 loader 转换非 JavaScript 模块(如 CSS 转成 JS 可处理的模块),再通过插件(plugin)完成额外的优化操作(如代码压缩、拆分),最终将所有依赖模块打包成一个或多
个静态资源文件(bundle),供浏览器加载使用。
核心核心思想:
- 一切皆模块:资源文件(js/css/img 等)均可通过 import/require 导入,视为模块;
- 依赖图谱:递归解析入口文件,构建所有模块的依赖关系图谱(dependency graph);
- 转换器(loader):处理非 JS 模块,将其转为 Webpack 可识别的模块;
- 扩展器(plugin):介入打包全流程,实现压缩、拆分、优化等复杂功能。
- Webpack 完整打包过程
Webpack 的打包过程分为三大阶段,每个阶段包含具体的执行步骤:
阶段一:初始化阶段(准备工作)
- 解析配置文件:Webpack 读取项目根目录的 webpack.config.js(或其他配置文件),结合
命令行参数(如 --mode production),合并生成最终的打包配置对象;
- 初始化 Compiler 实例:根据最终配置,创建 Webpack 的核心编译器实例(Compiler),
Compiler 负责统筹整个打包流程,生命周期钩子也基于该实例触发;
- 初始化插件:遍历配置中的 plugins 数组,执行插件的 apply 方法,将插件挂载到
Compiler 的生命周期钩子上,为后续打包过程做准备。
阶段二:编译阶段(构建依赖图谱+转换模块)
- 依赖递归收集:解析当前模块时,提取其中的 import/require 依赖声明,递归解析依赖的模
块,直到所有依赖都被解析完毕;
- 构建依赖图谱:在解析过程中,Webpack 会将所有模块及其依赖关系记录下来,形成一个完整的
依赖图谱(dependency graph),每个模块都有唯一的标识(module ID)。
阶段三:输出阶段(生成 bundle 文件)
- 模块分块:根据配置中的 optimization.splitChunks 等选项,将依赖图谱中的模块拆分到
不同的 chunk(代码块)中(如入口 chunk、第三方依赖 chunk、异步 chunk 等);
- 生成打包代码:对每个 chunk 进行处理,将模块代码拼接、封装(如生成 webpack_require
函数用于模块加载),转换为浏览器可运行的代码;
- 插件执行优化:在输出过程中,触发各类插件的生命周期钩子(如 TerserPlugin 压缩 JS 代
码、 MiniCssExtractPlugin 提取 CSS 为单独文件、 HtmlWebpackPlugin 生成 HTML 文件并引入 bundle);
- 输出文件:将处理后的 chunk 文件输出到配置中的 output.path 目录下,文件名遵循
output.filename 等配置规则,完成整个打包流程。
五、Webpack 生产环境打包优化配置
生产环境打包的核心目标是:减小 bundle 体积、提高代码运行效率、优化浏览器加载速度,具体配置方案如下:
- 基础配置优化
• 指定 mode 为 production:
这是最基础的优化, mode: 'production' 会自动启用 Webpack 内置的优化功能(如代码压缩、树摇、作用域提升等),无需手动配置。
Code block
1module.exports = { 2mode: 'production', // 生产环境模式
3entry: './src/index.js', 4output: {
| 5 | filename: '[name].[contenthash].js',//内容哈希,用于缓存优化 |
|---|---|
| 6 | path: path.resolve(__dirname, 'dist'), |
| 7 | clean: true,//打包前清空dist目录 |
| 8 | } |
| 9 } |
• 启用树摇(Tree Shaking):
树摇用于删除项目中未被使用的代码(死代码),仅支持 ES 模块( import/export),需满足两个条件: mode: 'production' + 代码为 ES 模块(避免使用 CommonJS 模块)。
额外配置(可选,增强树摇效果):
Code block
1module.exports = { 2optimization: {
| 3 | usedExports: true,//标记未被使用的导出 |
|---|---|
| 4 | } |
| 5 } |
• 作用域提升(Scope Hoisting):
将多个小模块合并为一个大模块,减少函数声明和模块加载的开销,提高代码运行效率, mode:
'production' 自动启用,手动配置如下:
Code block
1module.exports = { 2optimization: {
| 3 | concatenateModules: true,//启用作用域提升 |
|---|---|
| 4 | } |
| 5 } |
• 代码分割(Code Splitting):
将大 bundle 拆分为多个小 bundle,实现按需加载(首屏加载更快),同时缓存复用(公共代码不重复加载),核心配置:
Code block
1module.exports = { 2optimization: {
3splitChunks: {
| 4 | chunks: 'all',//拆分所有类型的chunk(入口chunk +异步chunk) |
|---|---|
| 5 | cacheGroups: { |
| 6 | vendor: {//拆分第三方依赖(如react、vue) |
| 7 | test: /[\\/]node_modules[\\/]/, |
全站分卷索引 · 26 卷
- 1第 1 卷
- 深入解析:npm 安装包及四大包管理工具对比
- 一、npm 安装包的完整过程
- ◦ 先检查项目根目录的 package.json 文件,读取目标包的版本约束(如 ^1.2.3、
- ◦ 结合 package-lock.json(npm 5+ 新增)或 npm-shrinkwrap.json,优先锁定已
- ◦ 更新 package-lock.json:记录本次安装的所有包的精确版本、依赖关系、下载地址等信
- ◦ 执行生命周期脚本:若包自身或项目中配置了 preinstall、 install、
- • 性能排序(安装速度+磁盘占用):pnpm > yarn > cnpm > npm(最新版 npm 已优化,差距缩
- • 网络优化:cnpm 依赖国内镜像,npm/yarn/pnpm 可手动配置镜像,pnpm 缓存跨项目复用更
- 三、pnpm 存储结构减少磁盘占用+提高安装速度的原理
- • 全局共享存储目录:pnpm 会在系统中创建一个全局共享存储目录(默认路径:Windows
- • 硬链接复用包内容:硬链接是文件系统层面的特性,它不复制文件本身,仅创建一个指向原文件数
- • 符号链接组织依赖结构:pnpm 不采用扁平依赖结构,而是通过符号链接在项目
- 2第 2 卷
- 3第 3 卷
- 4第 4 卷
- • 使用 ESBuild 替代 Babel/Terser(可选):
- 总结
- 六、loader和plugin的区别及其在Webpack中的作用
- • 定位不同:loader 专注于“模块转换”,解决非 JS/JSON 模块的加载与转译问题;plugin 专注
- • 工作时机不同:loader 仅在“编译阶段”(解析模块时)执行,针对单个模块进行处理;plugin
- • 使用方式不同:loader 配置在 module.rules 中,通过 test 匹配目标文件,指定对应的
- • loader的作用:将非 JS/JSON 模块转换为 Webpack 可识别的模块,以便纳入依赖图谱进行打
- • plugin的作用:扩展 Webpack 的构建能力,覆盖从初始化配置到输出文件的全流程,实现
- 七、如何使用Webpack来处理CSS和Sass
- • 步骤1:安装依赖:
- • 步骤2:Webpack配置:
- • 生产环境(提取为单独 CSS 文件):
- 5第 5 卷
- 6第 6 卷
- 7第 7 卷
- 8第 8 卷
- • 排除无需处理的文件:通过 exclude 配置排除 node_modules、 dist 等目录,避免
- • 使用 thread-loader 开启多线程构建:将耗时的 loader 任务(如 Babel 转译、Sass 转译)分配到
- • 禁用生产环境相关优化(开发环境):开发环境无需启用代码压缩( TerserPlugin)、CSS 提
- 补充总结
- • 依赖静态分析:ES 模块的导入导出是静态的(导入导出语句只能在模块顶层,且不能动态判
- • 删除死代码:在代码压缩阶段(如 TerserPlugin),将标记的死代码删除,最终生成精简的
- • 代码必须使用 ES 模块( import/export):避免使用 CommonJS 模块( require 是动态
- • 指定 mode: 'production':Webpack 在生产环境下会自动启用 Tree Shaking(内置
- • 优化 usedExports(标记未使用导出):显式标记未被使用的导出,增强 TerserPlugin 的删除效
- • 通过 package.json 配置 sideEffects(排除有副作用的模块):
- 9第 9 卷
- 10第 10 卷
- • HMR 体验:在 React 项目中修改某个组件的样式或逻辑,页面无刷新,组件样式/逻辑实时更新,
- • environment:Webpack 环境准备完成后触发(如 Node.js 环境变量配置),插件可在此阶段获
- • entryOption:在 Webpack 解析入口配置( entry)后触发,可用于修改入口配置(如动态添
- • afterResolvers:解析器(resolver,用于查找模块路径)初始化完成后触发,可用于自定义模块
- • beforeRun:在 Compiler 开始执行编译前触发(仅在首次构建和 watch 模式下重新构建时触
- • watchRun:仅在 watch 模式下(文件变化触发重新构建)触发,在编译开始前执行,可用于监听
- • compilation:当一个新的 Compilation 实例(负责模块解析、依赖收集、生成 chunk)被创建时
- • normalModuleFactory:普通模块工厂(用于创建普通模块,如 JS 模块)初始化时触发,可用
- • contextModuleFactory:上下文模块工厂(用于创建上下文模块,如
- • moduleAsset:当一个模块生成对应的资源(如图片、CSS 文件)时触发,可用于跟踪模块与资
- • shouldEmit:在输出文件前触发,返回 boolean 值,决定是否输出文件(返回 false 可终止
- • emit:在输出文件到磁盘前触发,是插件修改输出资源的关键钩子(如 TerserPlugin 在此阶
- 11第 11 卷
- 12第 12 卷
- 13第 13 卷
- 14第 14 卷
- • 重复编译未变化模块:开发环境中未启用缓存,每次代码修改后都全量重新编译,而非仅编译变化
- • 资源处理低效:
- • 配置不合理:
- • 项目本身复杂度高:模块数量庞大(千级以上)、依赖链过深、存在大量动态依赖,导致
- • Webpack 内置缓存(Webpack 5+):配置 cache 选项,将模块缓存到内存或磁盘,重启开发
- • Loader 缓存:为耗时 Loader(如 babel-loader、 sass-loader)启用缓存,避免重复转
- • 预编译第三方依赖(DllPlugin):第三方依赖(如 React、Vue)极少变化,通过 DllPlugin
- • 排除无需处理的文件:通过 exclude 排除 node_modules、 dist 等目录,减少
- • 开启多线程构建:使用 thread-loader 将耗时的 Loader 任务分配到多个线程并行执行,充分
- 15第 15 卷
- • 优化静态资源处理:
- • 开发环境:禁用生产优化:开发环境核心目标是“快速构建”,无需启用代码压缩、CSS 提取等耗
- • 生产环境:精准优化:生产环境核心目标是“产物优化”,但需避免冗余配置:
- • 移除无用插件:检查插件列表,移除开发环境中不需要的生产插件(如 TerserPlugin、
- • 使用高效插件替代:
- • 拆分大型项目(Monorepo):对于大型项目,使用 Webpack 工作区(Workspaces)或
- • 减少动态依赖:尽量避免 require(`./${filename}`) 等动态依赖,改用静态导入,减少
- • 按需加载第三方依赖:对于体积大的第三方库(如 lodash),使用按需导入(如 import {
- • 开发体验极致:秒级启动开发服务器,毫秒级热更新,彻底解决大型项目开发时“启动慢、更新
- • 零配置开箱即用:默认支持 React、Vue、TypeScript、CSS 预处理器(Sass/Less)、静态资源等
- • 生产环境产物优化:基于 Rollup 打包,默认开启 Tree Shaking、代码分割、资源压缩等优化,产
- • 原生 ESM 支持:顺应前端模块化发展趋势,直接使用浏览器原生 ESM 能力,减少打包层的性能损
- 16第 16 卷
- • 配置灵活强大:支持深度自定义构建流程,可精准控制每一个环节(如模块解析、代码分割、缓存
- • 兼容性广泛:支持旧浏览器(如 IE 11),可通过 Loader 转译各类非标准模块,适配传统项目迁移
- • 多场景适配:对多页面应用、Monorepo、大型企业级项目的支持更成熟,案例丰富,问题解决方
- • 秒级开发服务器启动:无论项目大小(即使是千级模块的大型项目),开发服务器均可秒级启动,
- • 毫秒级热更新:代码修改后,仅需编译变化的模块,无需处理依赖链,更新速度恒定,不受项目规
- • 零配置开箱即用:默认支持 React、Vue、TypeScript、Sass/Less、CSS 模块、静态资源等主流场
- • 高效的生产构建:基于 Rollup 打包,默认开启 Tree Shaking、代码分割、资源压缩、懒加载等优
- • 丰富的内置功能:内置开发服务器、热更新、PostCSS、CSS 预处理器支持、静态资源处理等功
- • 预构建的原因:第三方依赖通常存在以下问题,影响加载效率:
- • 预构建的流程:
- • 兼容 Rollup 插件:Vite 生产环境基于 Rollup 打包,因此大部分 Rollup 插件可直接在 Vite 中使用
- • 扩展 Vite 特有钩子:在 Rollup 插件接口基础上,新增了针对 Vite 开发环境的特有钩子(如处理
- 17第 17 卷
- 18第 18 卷
- • changeOrigin:可选,默认 false。开启后,代理会修改请求头中的 Origin 字段为
- • rewrite:可选,路径重写函数。用于修改请求路径前缀(如前端用 /api 前缀标识接口请
- • secure:可选,默认 true。若目标服务器是 HTTPS 协议,且证书不被信任(如本地开发环
- • ws:可选,默认 false。开启后支持 WebSocket 代理(如后端有 WebSocket 服务时启
- • 代理仅作用于开发环境:Vite 的 server.proxy 是 Dev Server 的配置,生产环境打包后不生
- • 路径匹配规则:代理规则的键是请求路径的前缀,若多个规则匹配,优先匹配更具体的前缀(如
- • WebSocket 代理:若后端有 WebSocket 服务(如实时消息),需开启 ws: true,示
- 19第 19 卷
- • 模块格式不兼容:多数第三方依赖是 CommonJS 格式(如 lodash、moment),而 Vite 开发环
- • 大量小模块导致网络瀑布:部分依赖(如 React 生态、lodash-es)包含大量小模块(单个功能一
- • 依赖路径复杂:第三方依赖内部的路径引用可能包含别名、条件导入等,直接加载会导致解析失
- • 缓存存储位置:预构建结果缓存到项目根目录的 node_modules/.vite 文件夹中,包含转换
- • 缓存失效条件:仅当以下条件发生变化时,才会重新预构建,否则直接复用缓存:依赖版本变化
- • 必要依赖识别:Vite 会扫描项目的入口模块(如 src/main.js)及其直接/间接依赖,识别出需
- • 自定义预构建范围:通过 vite.config.js 的 optimizeDeps.include 和
- • Vite 内部使用 esbuild(基于 Go 语言的构建工具)进行依赖预构建, esbuild 本身支持并
- • 对于多个独立的第三方依赖(如 vue 和 axios),Vite 会并行触发 esbuild 处理,避免串
- • 例如: lodash-es 包含数百个小模块(如 lodash-es/map.js、 lodash-
- • 合并策略:Vite 会根据依赖的内部依赖关系,智能合并关联紧密的模块,避免合并后的包体积过
- • 多格式支持:原生支持 CommonJS → ESM 的转换、JSX 转译、TypeScript 转译等,无需额外配
- 20第 20 卷
- • Tree Shaking:自动移除未被使用的代码(死代码),仅保留被引用的模块和代码片段(基于
- • 代码分割(Code Splitting):自动拆分第三方依赖(如 vue、 axios)为独立 chunk(如
- • 对动态导入的模块(如 import('./pages/About.vue')),自动拆分为异步 chunk,实现
- • 开发环境:以“原生 ESM 支持”为核心,直接将静态资源作为模块加载,无需打包,确保开发体
- • 生产环境:以“优化输出”为核心,对静态资源进行压缩、哈希命名、按需转换(如小图片转
- • 零配置支持:默认支持常见静态资源类型( png、 jpg、 gif、 svg、 woff、 mp4
- • 开发环境:直接通过 import 或 url() 加载图片,Vite Dev Server 实时返回图片资源,支持
- • 小图片转 Base64:默认将小于 4KB 的图片转换为 Base64 编码,嵌入到 JS/CSS 中,减少 HTTP
- • SVG 特殊处理:支持直接导入 SVG 作为组件(需配合 @vitejs/plugin-vue 等框架插件),
- • 处理逻辑与图片类似:开发环境直接加载,生产环境自动压缩、哈希命名、输出到
- • 示例: // CSS 中引用字体
- • 开发环境:直接通过 import 或 <audio>/<video> 标签加载,Vite Dev Server 提供资源服
- 21第 21 卷
- 22第 22 卷
- • targets:决定转译的程度,目标环境越旧,转译后的代码兼容性越好,但体积越大。可通过
- • 语法转译插件:负责将 ES6+ 语法转为 ES5(如 @babel/plugin-transform-arrow-
- • 语法提案插件:负责转译尚未成为 ES 标准的语法(如 @babel/plugin-proposal-class-
- • 工具类插件:负责辅助转译过程(如 @babel/plugin-transform-runtime 复用辅助代码,
- • @babel/preset-env:核心预设,用于转译 ES6+ 语法,可根据目标环境按需加载插件(最常
- • @babel/preset-react:用于转译 React 的 JSX 语法,包含 @babel/plugin-
- • @babel/preset-es2015(已废弃):早期用于转译 ES2015 语法,现被
- • 预设按配置顺序从右到左执行(与插件相反)。例如上述配置中,先执行 @babel/preset-
- • 原因:预设是“插件集合”,右侧预设(如 TypeScript 转译)的输出可能需要左侧预设(如 ES6+
- 23第 23 卷
- • runtime: "automatic"(React 17+ 推荐):自动导入 react/jsx-runtime 模块中的 jsx
- • runtime: "classic"(旧版 React 16-):转译为 React.createElement 函数调用,需手动
- • 属性名转换:JSX 中的 className 转译为 className(避免与 JavaScript 关键字 class
- • 事件名转换:JSX 中的驼峰式事件名(如 onClick)保持不变,转译为函数调用的属性(如
- • 子节点处理:JSX 中的子元素(文本、其他 JSX 元素)会作为 children 参数传入 jsx 或
- • Fragment 处理:空标签 <></>(React Fragment)会转译为 jsx(React.Fragment,
- 24第 24 卷
- 25第 25 卷
- 26第 26 卷