搭建Webpack请参考:从零开始使用webpack 搭建vue项目
一、添加build包大小分析 webpack-bundle-analyzer
1.安装webpack-bundle-analyzer
pnpm install --save-dev webpack-bundle-analyzer
2.webpack.config.js 中添加相应配置
// webpack.config.js
const BundleAnalyzerPlugin = require('webpack-bundle-analyzer').BundleAnalyzerPlugin;
module.exports = {
// ...
plugins: [
// 开启 BundleAnalyzerPlugin
new BundleAnalyzerPlugin(),
],
};
BundleAnalyzerPlugin可以有一些默认配置项,如有特殊需求可以自行修改
// 默认配置项
new BundleAnalyzerPlugin({
// 可以是`server`,`static`或`disabled`。
// 在`server`模式下,分析器将启动HTTP服务器来显示软件包报告。
// 在“静态”模式下,会生成带有报告的单个HTML文件。
// 在`disabled`模式下,你可以使用这个插件来将`generateStatsFile`设置为`true`来生成Webpack Stats JSON文件。
analyzerMode: "server",
// 将在“服务器”模式下使用的主机启动HTTP服务器。
analyzerHost: "127.0.0.1",
// 将在“服务器”模式下使用的端口启动HTTP服务器。
analyzerPort: 8888,
// 路径捆绑,将在`static`模式下生成的报告文件。
// 相对于捆绑输出目录。
reportFilename: "report.html",
// 模块大小默认显示在报告中。
// 应该是`stat`,`parsed`或者`gzip`中的一个。
// 有关更多信息,请参见“定义”一节。
defaultSizes: "parsed",
// 在默认浏览器中自动打开报告
openAnalyzer: true,
// 如果为true,则Webpack Stats JSON文件将在bundle输出目录中生成
generateStatsFile: false,
// 如果`generateStatsFile`为`true`,将会生成Webpack Stats JSON文件的名字。
// 相对于捆绑输出目录。
statsFilename: "stats.json",
// stats.toJson()方法的选项。
// 例如,您可以使用`source:false`选项排除统计文件中模块的来源。
// 在这里查看更多选项:https: //github.com/webpack/webpack/blob/webpack-1/lib/Stats.js#L21
statsOptions: null,
logLevel: "info", // 日志级别。可以是'信息','警告','错误'或'沉默'。
});
3.启动配置
// package.json
"analyz": "NODE_ENV=production npm_config_report=true npm run build"
// 运行npm run analyz后打开 127.0.0.1:8888 可以可视化分析包大小信息
运行npm run analyz时如果出现下面这种情况,请参考文章:错误:NODE_ENV 不是内部或外部命令,也不是可运行的程序 或批处理文件
pnpm run analyz > webpack-vue@1.0.0 analyz E:\ASSA\演示demo\webpack-vue > NODE_ENV=production npm_config_report=true npm run build 'NODE_ENV' 不是内部或外部命令,也不是可运行的程序 或批处理文件。 ELIFECYCLE Command failed with exit code 1.
二、项目结构调整
为了项目的完整可持续发展,对项目目录进行调整。
为了方便后续调整文件路径以及路径太长,需要配置一个根目录标识
1.首先创建一个src文件夹,将页面信息统一放入src目录中
2.修改webpack.config.js 中的alias参数
引入文件或者使用目录时头部使用@/会定向到src目录下
module.exports = {
// ...
resolve: {
alias: {
'@': path.join(__dirname, 'src')
}
}
}
三、添加css style sass相关的loder
1.添加css-loader style-loader sass-loader sass
pnpm install --save-dev css-loader style-loader sass-loader sass
2.在webpack.config.js 中配置loader
Loader和Plugin详细介绍请看:Webpack中Loader与Plugin
module.exports = {
// ...
module: {
rules: [
{
test: /\.css$/,
use: [
{
loader: 'style-loader'
},
{
loader: 'css-loader'
}
]
}
]
}
}
3.安装postcss-loader 以及插件示例(厂商前缀添加、px转rem)
功能:不能简单的把 PostCSS 归类成 CSS 预处理或后处理工具。
把CSS 解析成 JavaScript 可以操作的 AST 。
调用插件来处理 AST 并得到结果。
首先需要安装postcss-loader依赖包
pnpm install --save-dev postcss-loader postcss
mini-css-extract-plugin插件快速入门:mini-css-extract-plugin插件快速入门
pnpm install --save-dev mini-css-extract-plugin
-
例1:统一厂商前缀添加
安装 postcss-preset-env依赖包
pnpm install --save-dev postcss-preset-env
在webpack.config.js 中配置loader
module.exports = {
module: {
rules: [
//...
{
test: /\.(sa|sc|c)ss$/, // 可以打包后缀为sass/scss/css的文件
use: [
{
loader: MiniCssExtractPlugin.loader,
options: {
// 这里可以指定一个 publicPath
// 默认使用 webpackOptions.output中的publicPath
// publicPath的配置,和plugins中设置的filename和chunkFilename的名字有关
// 如果打包后,background属性中的图片显示不出来,请检查publicPath的配置是否有误
publicPath: "./",
// publicPath: devMode ? './' : '../', // 根据不同环境指定不同的publicPath
//hmr: devMode, // 仅dev环境启用HMR功能
},
},
"css-loader",
"postcss-loader",
],
},
],
},
],
},
};
新增 postcss.config.js 配置文件
module.exports = {
plugins: [
[
"postcss-preset-env",
{
autoprefixer:{ grid: true },
browsers: 'last 2 versions' //这里很关键,原先是在package.json里面配置browserslist,但好像无效,花了很多时间,一直不知到问题,后面添加了这个就有效了,应该是browserslist配置的有问题。暂时先不研究了。
},
],
],
};
-
例2:统一px转rem
或者可以参考 (链接postcss-px-to-viewport),在淘宝flexible github上说’建议大家开始使用viewport来替代此方
安装postcss postcss-pxtorem依赖包
pnpm install postcss postcss-pxtorem --save-dev
配置postcss.config.js
module.exports = {
plugins: [
// ...
[
"postcss-pxtorem",
{
rootValue: 37.5,//表示根元素字体大小
// unitPrecision: 5,//允许REM单位增长到的十进制数字。
propList:['*','!font*'],//类似对正则匹配的设置黑白名单
// selectorBlackList:['body'],//设置白名单的标签或者正则匹配到的选择器
// minPixelValue:1,//设置要替换的最小像素值。
// mediaQuery:true,//(布尔)允许在媒体查询中转换px。
exclude:/node_modules/i//需要忽略的文件路径
}
]
],
};
4.css提取单独的文件 mini-css-extract-plugin
本插件会将 CSS 提取到单独的文件中,为每个包含 CSS 的 JS 文件创建一个 CSS 文件,并且支持 CSS 和 SourceMaps 的按需加载
安装mini-css-extract-plugin依赖
pnpm install --save-dev mini-css-extract-plugin
配置webpack.config.js
const MiniCssExtractPlugin = require("mini-css-extract-plugin");
module.exports = {
plugins: [new MiniCssExtractPlugin({
// ...配置
})],
module: {
rules: [
{
test: /\.css$/i,
use: [MiniCssExtractPlugin.loader, "css-loader"],
},
],
},
};
四、资源模块
在webpack5之前对于资源加载一般都是 row-loader,url-loader file-loader
webpack5 拥有asset module type 可以替换4中新的模块类型
- asset/resource == file-loader
- asset/inline == url-loader
- asset/source == row-loader
- asset
在webpack.config.js 中加入配置
//
// ...
module: {
// noParse: /jquery|lodash/, //可以忽略大型的library可以提高构建性能
rules: [
{
test: /\.(png|jpg|gif|jpeg)(\?[a-z0-9]+)?$/,
type: 'asset/resource',
parser:{
dataUrlCondition:{
maxSize: 10 * 1024,//小10KB的资源以内联base64的形式(默认)
}
}
},
// ...
]
}