webapck4配置详解

entry

1. string --> ‘./src/index.js’

   单入口

   打包形成一个chunk。 输出一个bundle文件。

   此时chunk的名称默认是 main

2. array --> [’./src/index.js’, ‘./src/add.js’]

   多入口

   所有入口文件最终只会形成一个chunk, 输出出去只有一个bundle文件。

   –>在HMR功能中让html热更新生效~

3. object

   多入口

   有几个入口文件就形成几个chunk，输出几个bundle文件

   此时chunk的名称是 key

4. 特殊用法

   {

   // 所有入口文件最终只会形成一个chunk, 输出出去只有一个bundle文件。

   index: [’./src/index.js’, ‘./src/count.js’],

   // 形成一个chunk，输出一个bundle文件。

   add: ‘./src/add.js’

   }

output

  output: {
    // 文件名称（指定名称+目录）
    filename: 'js/[name].js',
    // 输出文件目录（将来所有资源输出的公共目录）
    path: resolve(__dirname, 'build'),
    // 所有资源引入公共路径前缀 --> 'imgs/a.jpg' --> '/imgs/a.jpg'
    publicPath: '/',
    chunkFilename: 'js/[name]_chunk.js', // 非入口chunk的名称
    // library: '[name]', // 整个库向外暴露的变量名
    // libraryTarget: 'window' // 变量名添加到哪个上 browser
    // libraryTarget: 'global' // 变量名添加到哪个上 node
    // libraryTarget: 'commonjs'
  }

modules

{
  test: /\.js$/,
  // 排除node_modules下的js文件
  exclude: /node_modules/,
  // 只检查 src 下的js文件
  include: resolve(__dirname, 'src'),
  // 优先执行
  enforce: 'pre',
  // 延后执行
  // enforce: 'post',
  // 单个loader用loader
  loader: 'eslint-loader',
  options: {}
},
{
  // 以下配置只会生效一个
  oneOf: []
}

resolve

 // 解析模块的规则
resolve: {
  // 配置解析模块路径别名: 优点简写路径 缺点路径没有提示
  alias: {
    $css: resolve(__dirname, 'src/css')
  },
  // 配置省略文件路径的后缀名
  extensions: ['.js', '.json', '.jsx', '.css'],
  // 告诉 webpack 解析模块是去找哪个目录
  modules: [resolve(__dirname, '../../node_modules'), 'node_modules']
}

devServer

 devServer: {
    // 服务器运行代码的目录
    contentBase: resolve(__dirname, 'build'),
    // 监视 contentBase 目录下的所有文件，一旦文件变化就会 reload
    watchContentBase: true,
    watchOptions: {
      // 忽略文件
      ignored: /node_modules/
    },
    // 启动gzip压缩
    compress: true,
    // 端口号
    port: 5000,
    // 域名
    host: 'localhost',
    // 自动打开浏览器
    open: true,
    // 开启HMR功能
    hot: true,
    // 不要显示启动服务器日志信息
    clientLogLevel: 'none',
    // 除了一些基本启动信息以外，其他内容都不要显示
    quiet: true,
    // 如果出错了，不要全屏提示~
    overlay: false,
    // 服务器代理 --> 解决开发环境跨域问题
    proxy: {
      // 一旦devServer(5000)服务器接受到 /api/xxx 的请求，就会把请求转发到另外一个服务器(3000)
      '/api': {
        target: 'http://localhost:3000',
        // 发送请求时，请求路径重写：将 /api/xxx --> /xxx （去掉/api）
        pathRewrite: {
          '^/api': ''
        }
      }
    }
  }

optimization

主要看splitChunks的一个all, runtimeChunk解决的问题, minimizer更好的压缩

1. splitChunks设置chunks: all即可, 开启chunk分割, 公用的模块单独提取不会重复打包

2. runtimeChunk, 当使用import()引入模块时, 虽然会单独提取一个文件, 但是源文件会记录一个hash值

   例如在index.js中import(‘a.js’), a.js被提取出去了, 但是index.js中会记录a.js生成后的文件名

   当解决服务器强缓存不刷新时, 会以contenthash命名, 那么当a.js文件修改时, index.js中记录的contenthash值也会修改, 那么index.js就会更新, 因而index.js缓存失效

   此时就可以使用runtimeChunk来将切割提取的模块记录的name单独提取出来, index.js不记录, 则a.js更新只会引起记录的那个文件的更新

3. minimizer设置比默认情况下更好的压缩方式

optimization: {
    splitChunks: {
      chunks: 'all'
      // 默认值，可以不写~
      /* minSize: 30 * 1024, // 分割的chunk最小为30kb
      maxSiza: 0, // 最大没有限制
      minChunks: 1, // 要提取的chunk最少被引用1次
      maxAsyncRequests: 5, // 按需加载时并行加载的文件的最大数量
      maxInitialRequests: 3, // 入口js文件最大并行请求数量
      automaticNameDelimiter: '~', // 名称连接符
      name: true, // 可以使用命名规则
      cacheGroups: {
        // 分割chunk的组
        // node_modules文件会被打包到 vendors 组的chunk中。--> vendors~xxx.js
        // 满足上面的公共规则，如：大小超过30kb，至少被引用一次。
        vendors: {
          test: /[\\/]node_modules[\\/]/,
          // 优先级
          priority: -10
        },
        default: {
          // 要提取的chunk最少被引用2次
          minChunks: 2,
          // 优先级
          priority: -20,
          // 如果当前要打包的模块，和之前已经被提取的模块是同一个，就会复用，而不是重新打包模块
          reuseExistingChunk: true
        } 
      }*/
    },
    // 将当前模块的记录其他模块的hash单独打包为一个文件 runtime
    // 解决：修改a文件导致b文件的contenthash变化
    runtimeChunk: {
      name: entrypoint => `runtime-${entrypoint.name}`
    },
    minimizer: [
      // 配置生产环境的压缩方案：js和css
      new TerserWebpackPlugin({
        // 开启缓存
        cache: true,
        // 开启多进程打包
        parallel: true,
        // 启动source-map
        sourceMap: true
      })
    ]
  }