Webpack的打包大小和CSS style sass配置即优化

蜡笔小开心

已于 2023-08-16 15:46:37 修改

阅读量347

点赞数

文章标签： webpack 前端 node.js

于 2023-08-15 22:08:54 首次发布

本文链接：https://blog.csdn.net/wzr514420887/article/details/132306702

版权

搭建Webpack请参考：从零开始使用webpack 搭建vue项目

一、添加build包大小分析 webpack-bundle-analyzer

详细请参考文章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的形式（默认）
               }
             }
         },
         // ...
     ]
 }