webpack从相识到合葬(3)-生产环境的基本配置

上一章介绍了如何在开发环境下配置webpack.As we all known,开发环境没有那么多讲究,怎么速度快怎么来.但是生产环境就不一样了,要体积小,要跑得快,还要兼容性好...等等一系列要求.
比如css的处理,是通过loader加载到js文件中,就会让js体积变得很大.同时css样式是通过js创建style标签并放入head,会产生闪屏现象.所以生产环境下需要将css样式从js文件中提取出来,单独处理
再比如代码压缩问题,注释,空格,贼长的变量名,这些在生产环境中都不需要,反正只要语法没问题,浏览器能看懂就行.什么?你说你能看懂jQuery-min.js文件???
还比如js/css的兼容性问题,flex,animation...需要加一些前缀才能在低版本浏览器中运行
...
总之就是让你的代码更快更好更强更平稳的运行在生产环境上.
不过话说回来,生产环境下的配置也都是可以用在开发环境下的,就是每次打包的速度会变慢,讲到根儿上,开发环境就是图快图方便.

提取css文件成单独文件

下载mini-css-extract-plugin

const { resolve } = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');
const MiniCssExtractPlugin = require('mini-css-extract-plugin');

module.exports = {
  entry: './src/js/index.js',
  output: {
    filename: 'js/built.js',
    path: resolve(__dirname, 'build')
  },
  module: {
    rules: [
      {
        test: /\.css$/,
        use: [
          // 'style-loader', 
          // 这个loader取代style-loader。作用：提取js中的css成单独文件
          MiniCssExtractPlugin.loader,
          'css-loader'
        ]
      }
    ]
  },
  plugins: [
    new HtmlWebpackPlugin({
      template: './src/index.html'
    }),
    new MiniCssExtractPlugin({
      // 对输出的css文件进行重命名
      // 如果不配置的话,css文件会输出到项目跟路径下,并且命名为main.css
      filename: 'css/built.css'
    })
  ],
  mode: 'development'
};

处理css兼容性

下载postcss-loader postcss-preset-env

const { resolve } = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');
const MiniCssExtractPlugin = require('mini-css-extract-plugin');

// 设置nodejs环境变量
process.env.NODE_ENV = 'development';

module.exports = {
  entry: './src/js/index.js',
  output: {
    filename: 'js/built.js',
    path: resolve(__dirname, 'build')
  },
  module: {
    rules: [
      {
        test: /\.css$/,
        use: [
          MiniCssExtractPlugin.loader,
          'css-loader',
            //postcss-preset-env帮postcss找到package.json中browserslist里面的配置，通过配置加载指定的css兼容性样式
            
          // 使用loader的默认配置
          // 'postcss-loader',
          // 修改loader的配置
          {
            loader: 'postcss-loader',
            options: {
              ident: 'postcss',
              plugins: () => [
                // postcss的插件
                require('postcss-preset-env')()
              ]
            }
          }
        ]
      }
    ]
  },
  plugins: [
    new HtmlWebpackPlugin({
      template: './src/index.html'
    }),
    new MiniCssExtractPlugin({
      filename: 'css/built.css'
    })
  ],
  mode: 'development'
};

在package.json中添加browserslist配置,以下只是示例,大家可以去github上搜索browserslist来看具体的配置
默认是生产环境,如果需要激活开发环境,需要在webpack.config.js中设置nodejs的环境变量 process.env.NODE_ENV = 'development'

"browserslist": {
  "development": [
    "last 1 chrome version",
    "last 1 firefox version",
    "last 1 safari version"
  ],
  "production": [
    ">0.2%",
    "not dead",
    "not op_mini all"
  ]
}

压缩css

这一个大概是所有配置里最简单的了
首先,下载'optimize-css-assets-webpack-plugin'
其次,引入
const OptimizeCssAssetsWebpackPlugin = require('optimize-css-assets-webpack-plugin')
再次,在plugins中添加
new OptimizeCssAssetsWebpackPlugin()
一般情况下,插件的默认配置足够使用,若想更过个性化配置,请自行搜索设置

js语法检查

下载eslint-loader  eslint eslint-config-airbnb-base  eslint-plugin-import
语法风格采用airbnb,更多风景请去github自行欣赏

module.exports = {
  entry: '',
  output: {},
  module: {
    rules: [
      /*
      语法检查： eslint-loader  eslint
      注意：只检查自己写的源代码，第三方的库是不用检查的
            eslint不认识window,navigator全局变量,要配置env
      设置检查规则：
        package.json中eslintConfig中设置~
          "eslintConfig": {
            "extends": "airbnb-base",
            "env": {
              "browser": true
            }
          }
      */
      {
        test: /\.js$/,
        //排除掉node_modules的第三方库
        exclude: /node_modules/,
        loader: 'eslint-loader',
        options: {
          // 自动修复eslint的错误
          fix: true
        }
      }
    ]
  },
  plugins: [],
  mode: 'development'
};

js兼容性处理

下载 babel-loader @babel/core @babel/preset-env @babel/polyfill core-js

module.exports = {
  entry: '',
  output: {},
  module: {
    rules: [
      /*
        js兼容性处理：babel-loader @babel/core 
          1. 基本js兼容性处理 --> @babel/preset-env
            问题：只能转换基本语法，如promise高级语法不能转换
          2. 全部js兼容性处理 --> @babel/polyfill  
             在js文件中 import '@babel/polyfill'
             问题：太暴力,我只要解决部分兼容性问题，但是将所有兼容性代码全部引入，体积太大了~
          3. 需要做兼容性处理的就做：按需加载  --> core-js
             使用这种方式,就不能使用第二种方式,要去掉js文件中的import '@babel/polyfill'
      */  
      {
        test: /\.js$/,
        exclude: /node_modules/,
        loader: 'babel-loader',
        options: {
          // 预设：指示babel做怎么样的兼容性处理
          presets: [
            [
              '@babel/preset-env',
              {
                // 按需加载
                useBuiltIns: 'usage',
                // 指定core-js版本
                corejs: {
                  version: 3
                },
                // 指定兼容性做到哪个版本浏览器
                targets: {
                  chrome: '60',
                  firefox: '60',
                  ie: '9',
                  safari: '10',
                  edge: '17'
                }
              }
            ]
          ]
        }
      }
    ]
  },
  plugins: [],
  mode: 'development'
};

压缩js和html

压缩js,只需要将mode设置为production,因为生产环境下会启用如UglifyJsPlugin等插件

压缩html
const HtmlWebpackPlugin = require('html-webpack-plugin');

module.exports = {
  entry: '',
  output: {},
  plugins: [
    new HtmlWebpackPlugin({
      template: './src/index.html',
      // 压缩html代码
      minify: {
        // 移除空格
        collapseWhitespace: true,
        // 移除注释
        removeComments: true
      }
    })
  ],
  mode: 'development'
};

完整的生产环境配置

const { resolve } = require('path');
const MiniCssExtractPlugin = require('mini-css-extract-plugin');
const OptimizeCssAssetsWebpackPlugin = require('optimize-css-assets-webpack-plugin');
const HtmlWebpackPlugin = require('html-webpack-plugin');

// 定义nodejs环境变量：决定使用browserslist的哪个环境
process.env.NODE_ENV = 'production';

// 复用loader
const commonCssLoader = [
  MiniCssExtractPlugin.loader,
  'css-loader',
  {
    // 还需要在package.json中定义browserslist
    loader: 'postcss-loader',
    options: {
      ident: 'postcss',
      plugins: () => [require('postcss-preset-env')()]
    }
  }
];

module.exports = {
  entry: './src/js/index.js',
  output: {
    filename: 'js/built.js',
    path: resolve(__dirname, 'build')
  },
  module: {
    rules: [
      {
        test: /\.css$/,
        use: [...commonCssLoader]
      },
      {
        test: /\.less$/,
        use: [...commonCssLoader, 'less-loader']
      },
      /*
        正常来讲，一个文件只能被一个loader处理。
        当一个文件要被多个loader处理，那么一定要指定loader执行的先后顺序：
          先执行eslint 再执行babel
      */
      {
        // 在package.json中eslintConfig --> airbnb
        test: /\.js$/,
        exclude: /node_modules/,
        // 优先执行
        enforce: 'pre',
        loader: 'eslint-loader',
        options: {
          fix: true
        }
      },
      {
        test: /\.js$/,
        exclude: /node_modules/,
        loader: 'babel-loader',
        options: {
          presets: [
            [
              '@babel/preset-env',
              {
                useBuiltIns: 'usage',
                corejs: {version: 3},
                targets: {
                  chrome: '60',
                  firefox: '50'
                }
              }
            ]
          ]
        }
      },
      {
        test: /\.(jpg|png|gif)/,
        loader: 'url-loader',
        options: {
          limit: 8 * 1024,
          name: '[hash:10].[ext]',
          outputPath: 'imgs',
          esModule: false
        }
      },
      {
        test: /\.html$/,
        loader: 'html-loader'
      },
      {
        exclude: /\.(js|css|less|html|jpg|png|gif)/,
        loader: 'file-loader',
        options: {
          outputPath: 'resources'
        }
      }
    ]
  },
  plugins: [
    new MiniCssExtractPlugin({
      filename: 'css/built.css'
    }),
    new OptimizeCssAssetsWebpackPlugin(),
    new HtmlWebpackPlugin({
      template: './src/index.html',
      minify: {
        collapseWhitespace: true,
        removeComments: true
      }
    })
  ],
  mode: 'production'
};