webpack应用指南二(高级篇)
根据尚硅谷视频教程及webpack5官网部分内容整理。
尚硅谷Web前端之Webpack5教程文档
Webpack中文官网
减少代码体积
减少Babel生成文件的体积*
Babel为编译的每个文件都插入了辅助代码,使代码体积过大。Babel对一些公共方法使用了非常小的辅助代码,比如 _extend。默认情况下会被添加到每一个需要它的文件中。所以可以将这些辅助代码作为一个独立模块,来避免重复引入。
使用插件@babel/plugin-transform-runtime,该插件禁用了Babel自动对每个文件的runtime注入,引入@babel/plugin-transform-runtime并且使所有辅助代码从这里引用。配置时在babel-loader的“plugins”属性中引入该插件,配置方式如下。
安装插件@babel/plugin-transform-runtime:npm i @babel/plugin-transform-runtime -D
// webpack.dev.js/webpack.prod.js
...
module.exports = {...},
// 模块
module: {
rules: [
{
oneOf: [
{...},
{...},
{...},
{...},
{
test: /\.m?js$/,
exclude: /(node_modules|bower_components)/,
use: [
{
loader: "thread-loader", // 开启多进程
options: {
workers: threads, // 数量
},
},
{
loader: 'babel-loader',
options: {
cacheDirectory: true, // 开启babel编译缓存
cacheCompression: false, // 缓存文件不要压缩
plugins: ['@babel/plugin-transform-runtime'], // 减少babel体积
}
},
]
}
]
}
]
},
...
};
压缩图片【生产环境】
开发如果项目中引用了较多图片,那么图片体积会比较大,将来请求速度比较慢。可以对图片进行压缩,减少图片体积。
注意:如果项目中图片都是在线链接,那么就不需要了。本地项目静态图片才需要进行压缩。
image-minimizer-webpack-plugin:用来压缩图片的插件。
安装:npm i image-minimizer-webpack-plugin imagemin -D。
此外,还需要其他依赖包进行下载,分为无损模式和有损模式。
- 无损压缩:
npm install imagemin-gifsicle imagemin-jpegtran imagemin-optipng imagemin-svgo -D - 有损压缩:
npm install imagemin-gifsicle imagemin-mozjpeg imagemin-pngquant imagemin-svgo -D
以无损模式配置为例,配置方式如下。
// webpack.prod.js
...
// 引入图片压缩文件
const ImageMinimizerPlugin = require("image-minimizer-webpack-plugin");
const threads = os.cpus().length-1;
function getCommonStyleSets(pre) {...}
module.exports = {
// 入口
entry: './src/main.js',
// 输出
output: {...},
// 模块
module: {...},
// 插件
plugins:[...],
optimization: {
// 告知 webpack 使用 TerserPlugin 或其它在 optimization.minimizer定义的插件压缩 bundle。
minimize: true,
// 允许通过提供一个或多个定制过的 TerserPlugin 实例,覆盖默认压缩工具(minimizer)。
minimizer: [
// css压缩也可以写到optimization.minimizer里面,效果一样的
new CssMinimizerPlugin(),
// 当生产模式会默认开启TerserPlugin,但是我们需要进行其他配置,就要重新写了
new TerserPlugin({
parallel: threads // 开启多进程
}),
// 配置图片压缩
new ImageMinimizerPlugin({
minimizer: {
implementation: ImageMinimizerPlugin.imageminGenerate,
options: {
plugins: [
["gifsicle", { interlaced: true }],
["jpegtran", { progressive: true }],
["optipng", { optimizationLevel: 5 }],
[
"svgo",
{
plugins: [
"preset-default",
"prefixIds",
{
name: "sortAttrs",
params: {
xmlnsOrder: "alphabetical",
},
},
],
},
],
],
},
},
}),
],
},
// 模式
mode: 'production',
devtool: 'source-map'
};
打包时如果出现报错,很可能是下载依赖包时下载失败,缺少执行文件,比如jpegtran.exe、optipng.exe等,具体请查看报错信息。可取相应官网地址手动下载缺少的文件,并放置到对应位置。
jpegtran 官网地址。OptiPNG 官网地址。
优化代码运行性能
Code Split
打包代码时会将所有js文件打包到一个文件中,体积很大。如需要渲染首页内容,就应该只加载首页的js文件,其他文件不应该加载。所以需要将打包生成的文件进行代码分割,生成多个js文件,渲染哪个页面就只加载某个js文件,这样加载的资源就少,速度就更快。
代码分割(Code Split)主要做了两件事:
- 分割文件:将打包生成的文件进行分割,生成多个
js文件。 - 按需加载:需要哪个文件就加载哪个文件。
多入口文件
当项目有多个入口文件时,需要打包生成多个入口文件。如下所示
entry: {
main: "./src/main.js",
app: "./src/app.js",
},
打包后会生成两个入口文件,文件名称我们可以使用自定义,例如[name],如下所示:
// webpack.config.js
const path = require("path");
const HtmlWebpackPlugin = require("html-webpack-plugin");
module.exports = {
// 多入口
entry: {
main: "./src/main.js",
app: "./src/app.js",
},
output: {
path: path.resolve(__dirname, "./dist"),
// [name]是webpack命名规则,使用chunk的name作为输出的文件名。
// 什么是chunk?打包的资源就是chunk,输出出去叫bundle。
// chunk的name是啥呢? 比如: entry中xxx: "./src/xxx.js", name就是xxx。注意是前面的xxx,和文件名无关。
// 为什么需要这样命名呢?如果还是之前写法main.js,那么打包生成两个js文件都会叫做main.js会发生覆盖。(实际上会直接报错的)
filename: "js/[name].js",
clear: true,
},
plugins: [...],
mode: "production",
};
提取重复代码
当多入口文件中都引用了同一份代码,我们不希望这份代码被重复打包到两个文件中,导致代码重复,体积更大。此时我们需要提取多入口的重复代码,只打包生成一个js文件,其他文件引用它就好。
例如,入口文件app.js和main.js中都引用了math.js文件,我们需要在webpack配置文件中配置splitChunks属性避免重复打包,如下所示。
...
module.exports = {
// 多入口
entry: {
main: "./src/main.js",
app: "./src/app.js",
},
output: {...},
plugins: [...],
mode: "production",
optimization: {
// 代码分割配置
splitChunks: {
chunks: "all", // 对所有模块都进行分割
// 以下是默认值
// minSize: 20000, // 分割代码最小的大小
// minRemainingSize: 0, // 类似于minSize,最后确保提取的文件大小不能为0
// minChunks: 1, // 至少被引用的次数,满足条件才会代码分割
// maxAsyncRequests: 30, // 按需加载时并行加载的文件的最大数量
// maxInitialRequests: 30, // 入口js文件最大并行请求数量
// enforceSizeThreshold: 50000, // 超过50kb一定会单独打包(此时会忽略minRemainingSize、maxAsyncRequests、maxInitialRequests)
// 修改配置
cacheGroups: {
// 组,哪些模块要打包到一个组
// defaultVendors: { // 组名
// test: /[\\/]node_modules[\\/]/, // 需要打包到一起的模块
// priority: -10, // 权重(越大越高)
// reuseExistingChunk: true, // 如果当前 chunk 包含已从主 bundle 中拆分出的模块,则它将被重用,而不是生成新的模块
// },
default: {
// 其他没有写的配置会使用上面的默认值
minSize: 0, // 我们定义的文件体积太小了,所以要改打包的最小文件体积
minChunks: 2,
priority: -20,
reuseExistingChunk: true,
},
},
},
},
};
按需动态加载
想要实现按需加载,动态导入模块。还需要额外配置。所谓按需加载,是指页面加载仅加载需要呈现的内容,对于按钮或者其他不需要初始化加载的js文件等,可配置动态加载模式,仅在触发时加载。如下所示。
// main.js
console.log("hello main");
document.getElementById("btn").onclick = function () {
// 动态导入 --> 实现按需加载。该方法是按钮btn上的onClick事件,无需初始化时加载。
// 即使只被引用了一次,也会代码分割
import("./math.js").then(({ sum }) => {
alert(sum(1, 2, 3, 4, 5));
});
};
单入口
开发时如果是单页面应用(SPA),只有一个入口(单入口)。可进行如下配置。
// webpack.prod.js
...
function getCommonStyleSets(pre) {...}
module.exports = {
...
optimization: {
...
splitChunks:{
chunks: "all"
// 其他取默认值,或者自行配置
}
},
....
};
自定义按需动态导入文件名称
对于按需导入的文件,可使用webpackChunkName: name的方式自定义文件名称。如下所示
// main.js
import count from "./js/count";
import sum from './js/sum';
import { cube } from './js/math';
// 需要引入才能被打包
import './css/index.css';
import './less/index.less';
console.log(count(1,2));
console.log(sum(1,2,3,4));
console.log(cube(3));
// 判断是否开启热模块替换
if(module.hot){
// 有回调函数
module.hot.accept('./js/count.js',function(){
const result1 = count(2, 1);
console.log("new ",result1);
});
// 无回调函数
module.hot.accept('./js/sum.js');
}
document.getElementById("btn").onclick = function() {
// webpackChunkName: "math":这是webpack动态导入模块命名的方式
import(/* webpackChunkName:"newtest" */"./js/newTest.js").then(({ sums }) => {
console.log(sums(1,2,3))
});
}
统一命名配置名称
对于打包的图片、字体等asset/resource文件可使用assetModuleFilename属性进行统一配置,可省略loader中配置的generator属性。同样对于chunk类的分割打包文件可使用chunkFilename进行区分配置,如下所示。
// webpack.prod.js
...
function getCommonStyleSets(pre) { ... }
module.exports = {
// 单入口
entry: './src/main.js',
// 输出
output: {
path: path.resolve(__dirname, '../dist'),
// js资源
filename: 'static/js/main.js',
chunkFilename: "static/js/[name].chunk.js", // 动态导入输出资源命名方式
assetModuleFilename: "static/media/[name].[hash][ext]", // 图片、字体等资源命名方式(注意用hash)
// 在打包前,将dist目录整个清空
clean: true
},
// 模块
module: {
rules: [
{
// oneOf实现只匹配一项loader,剩余loader不再匹配
oneOf: [
{...},
{...},
{
test: /\.(png|svg|jpg|jpeg|gif)$/i,
type: 'asset',
parser: {
dataUrlCondition: {
maxSize: 15 * 1024 // 小于15kb使用base64格式,其他引用图片路径
}
},
// generator: {
// // 控制图片输出路径及文件名称
// filename: 'static/imags/[hash:8][ext][query]'
// }
},
{
test: /\.(ttf|woff2?)$/,
type: "asset/resource",
// generator: {
// filename: "static/media/[hash:8][ext][query]",
// },
},
{...}
]
}
]
},
// 插件
plugins:[...],
optimization: {...},
// 模式
mode: 'production',
devtool: 'source-map'
};
Preload / Prefetch
虽然前面已经做了代码分割,同时会使用import动态导入语法来进行代码按需加载(也叫懒加载,比如路由懒加载就是这样实现的)。但是加载速度可能会有问题,比如:是用户点击按钮时才加载这个资源的,如果资源体积很大,加载速度慢,那么用户会感觉到明显卡顿效果。想在浏览器空闲时间,加载后续需要使用的资源。就需要用上Preload或Prefetch技术。
Preload:告知浏览器立即加载资源。Prefetch:告知浏览器在空闲时才开始加载资源。
共同点:都只会加载资源,并不执行。且都有缓存。
区别:Preload加载优先级高,Prefetch加载优先级低。Preload只能加载当前页面需要使用的资源,Prefetch可以加载当前页面资源,也可以加载下一个页面需要使用的资源。
问题:兼容性较差,Preload相对于Prefetch兼容性好一点。参考网站:Can I Use
配置如下。
安装包:npm i @vue/preload-webpack-plugin -D。
配置webpack.prod.js。
// webpack.prod.js
...
// preload插件
const PreloadWebpackPlugin = require("@vue/preload-webpack-plugin");
const threads = os.cpus().length-1;
function getCommonStyleSets(pre) { ... }
module.exports = {
...
// 模块
module: {...},
// 插件
plugins:[
...
new PreloadWebpackPlugin({
rel: "preload", // preload兼容性更好
as: "script",
// rel: 'prefetch' // prefetch兼容性更差
}),
],
optimization: {...},
// 模式
mode: 'production',
devtool: 'source-map'
};
Network Cache
项目开发时对静态资源会使用缓存来优化,浏览器第二次请求资源会读取缓存,速度很快。但是这样的话就会有一个问题, 因为前后输出的文件名是一样的,例如都叫main.js,一旦将来发布新版本,因为文件名没有变化导致浏览器会直接读取缓存,不会加载新资源,项目也就无法更新。所以需要确保更新前后文件名不一样,以便读取最新的文件内容。
fullhash(webpack4是hash)
每次修改任何一个文件,所有文件名的 hash 至都将改变。所以一旦修改了任何一个文件,整个项目的文件缓存都将失效。chunkhash
根据不同的入口文件(Entry)进行依赖文件解析、构建对应的chunk,生成对应的哈希值。我们js和css是同一个引入,会共享一个hash值。contenthash
根据文件内容生成hash值,只有文件内容变化了,hash值才会变化。所有文件hash值是独享且不同的。
webpack配置文件配置内容如下。
// webpack.prod.js
function getCommonStyleSets(pre) {...}
module.exports = {
...
// 输出
output: {
path: path.resolve(__dirname, '../dist'),
// js资源
// [contenthash:8]使用contenthash,取8位长度
filename: 'static/js/main.[contenthash:8].js',
chunkFilename: "static/js/[name].[contenthash:8].chunk.js", // 动态导入输出资源命名方式
assetModuleFilename: "static/media/[name].[hash][ext]", // 图片、字体等资源命名方式(注意用hash)
// 在打包前,将dist目录整个清空
clean: true
},
// 模块
module: {...},
// 插件
plugins:[
...
new MiniCssExtractPlugin({
// 定义输出的文件名和目录
filename: 'static/css/[name].[contenthash:8].css',
chunkFilename: "static/css/[name].[contenthash:8].chunk.css",
}),
...
],
...
};
但以上依旧会产生一个问题,例如main.js中引用了math.js文件。当修改了math.js文件再重新打包的时候,因为contenthash原因,math.js文件hash值发生了变化(这是正常的)。但是main.js文件的hash值也发生了变化,这会导致main.js的缓存失效。(因为main.js中引用了math.js,所以打包时由于math文件额hash值发生变化,导致main.js内容也发生了变化)。
解决方法是将hash值单独保管在一个runtime文件中。
最终会输出三个文件:main、math、runtime。当math文件发送变化,变化的是math和runtime文件,main不变。runtime文件只保存文件的hash值和它们与文件的映射关系,整个文件体积就比较小,所以变化重新请求的代价也小。
webpack配置方法如下。
// webpack.prod.js
function getCommonStyleSets(pre) {...}
module.exports = {
...
optimization: {
...
splitChunks:{
chunks: "all"
// 其他取默认值,或者自行配置
},
// 提取runtime文件
runtimeChunk: {
name: (entrypoint) => `runtime~${entrypoint.name}`, // runtime文件命名规则
},
},
...
};
Core-js
以上使用babel对js代码进行了兼容性处理,其中使用@babel/preset-env智能预设来处理兼容性问题。它能将ES6的一些语法进行编译转换,比如箭头函数、扩展运算符等。但是如果是async函数、promise对象、数组的一些方法(includes)等,它没办法处理。所以此时js代码仍然存在兼容性问题,一旦遇到低版本浏览器会直接报错。所以仍需要解决js代码的部分兼容性问题。
core-js是专门用来做ES6以及以上API的polyfill。polyfill翻译过来叫做垫片/补丁。就是用社区上提供的一段代码,让我们在不兼容某些新特性的浏览器上,使用该新特性。
下载并应用corejs包。
安装:npm i core-js。
- 手动全部引入
import "core-js";
// 添加promise代码
const promise = Promise.resolve();
promise.then(() => {
console.log("hello promise");
});
但这样引入会将所有兼容性代码全部引入,体积太大了。我们只想引入promise的polyfill。如下所示。
import "core-js/es/promise";
// 添加promise代码
const promise = Promise.resolve();
promise.then(() => {
console.log("hello promise");
});
只引入打包promise的polyfill,打包体积更小。但是将来如果还想使用其他语法,需要手动引入库很麻烦。可配置自动按需引入。
- 自动按需引入
// 不需要手动按需引入
// 添加promise代码
const promise = Promise.resolve();
promise.then(() => {
console.log("hello promise");
});
配置babel配置文件。
// babel.config.js
module.exports = {
presets: [
[
'@babel/preset-env',
// 按需加载core-js的polyfill
{ useBuiltIns: "usage", corejs: { version: "3", proposals: true } },
]
]
}
此时就会自动根据代码中使用的语法,来按需加载相应的polyfill。
PWA
开发Web App项目,项目一旦处于网络离线情况,就没法访问了。PWA可以给项目提供离线体验。
渐进式网络应用程序(progressive web application - PWA):是一种可以提供类似于native app(原生应用程序) 体验的Web App的技术。其中最重要的是,在离线(offline) 时应用程序能够继续运行功能。内部通过Service Workers技术实现的。配置方法如下。
安装依赖包:npm i workbox-webpack-plugin -D。
修改webpack配置文件。
// webpack.prod.js
function getCommonStyleSets(pre) {...}
module.exports = {
...
// 插件
plugins:[
...
// 离线处理
new WorkboxPlugin.GenerateSW({
// 这些选项帮助快速启用 ServiceWorkers
// 不允许遗留任何“旧的” ServiceWorkers
clientsClaim: true,
skipWaiting: true,
}),
],
...
};
但此时如果直接通过VSCode访问打包后页面,在浏览器控制台会发现SW registration failed。
因为我们打开的访问路径是:http://127.0.0.1:5500/dist/index.html。此时页面会去请求service-worker.js文件,请求路径是:http://127.0.0.1:5500/service-worker.js,这样找不到会导致404。
实际service-worker.js文件路径是:http://127.0.0.1:5500/dist/service-worker.js。
- 解决路径问题
安装依赖包:npm i serve -g。serve也是用来启动开发服务器来部署代码查看效果的。
运行指令:serve dist。此时通过serve启动的服务器我们service-worker就能注册成功了。
1954

被折叠的 条评论
为什么被折叠?



