Webpack 迁移到V4版本指南

Webpack 迁移到V4版本指南

需要升级的npm库列表

• "webpack": "^4.6.0",
• "webpack-cli": "^2.0.15",
• "webpack-dev-middleware": "^3.1.2",
• "webpack-hot-middleware": "^2.22.1",
• "file-loader": "^1.1.11",
• "url-loader": "^1.0.1",
• "html-webpack-plugin": "^3.2.0",
• "less": "^3.0.4",
• "less-loader": "^4.1.0",

webpack.config.js 调整

module 配置调整

module.loaders 变成 module.rules

module: {
    loaders: [
      {
        test: /\.css$/,
        loader: 'style!css',
      },
    ]
}

// change
// 注意新版本的loader不能省略，即：style-loader 不能写成 style
module: {
    rules: [
      {
        test: /\.css$/,
        use: [
          {loader: "style-loader"]},
          {loader: "css-loader"]},
        ]
      },
    ]
}

plugins 配置调整

• remove extract-text-webpack-plugin
• remove NoErrorsPlugin
• remove UglifyJsPlugin
• remove DedupePlugin
• remove NamedModulesPlugin
• remove HashedModulesPlugin
• rename webpack.optimize.OccurenceOrderPlugin to webpack.optimize.OccurrenceOrderPlugin

• remove CommonsChunkPlugin 改用 optimization.runtimeChuck 和 optimization.splitChunks

  onfig.optimization = {
    minimize: true,
    // runtimeChunk: 'single', // 测试发现这个设置成true或者single首页空白，无任何报错，因此暂时不做设置。
    splitChunks: {
      chunks: 'all',
      minSize: 30000,
      minChunks: 1,
      maxAsyncRequests: 5,
      maxInitialRequests: 3,
      automaticNameDelimiter: '~',
      name: true,
      cacheGroups: {
        vendors: {
          name: 'vendors',
          test: /[\\/]node_modules[\\/]/,
          priority: -10,
        },
        default: {
          minChunks: 2,
          priority: -20,
          reuseExistingChunk: true,
        },
      },
    },
  };

添加 mode

• 开发环境添加

  module.exports = {
    mode: 'development'
  }

• 生产环境

  module.exports = {
    mode: 'production'
  }

Code Spliting

Q&A

• Error: Cannot find module 'webpack/lib/ConcatSource'

  解决办法，移除：extract-text-webpack-plugin插件。（这里需要考虑如何抽离CSS）

• OccurenceOrderPlugin has been renamed to OccurrenceOrderPlugin

  解决办法，修改 OccurenceOrderPlugin 成 OccurrenceOrderPlugin

• ERROR in ./assets/images/icons/search.svg

  详细报错信息如下：

  ERROR in ./assets/images/icons/search.svg
  Module build failed: TypeError: Cannot read property 'context' of undefined
      at Object.loader (/Users/drew/Sites/my-site/node_modules/file-loader/dist/index.js:34:49)
  @ ./styles.sass 6:40863-40906

  解决办法：升级 url-loader 和 file-loader

• Cannot read property 'lessLoader' of undefined

  详细报错信息如下：

  ERROR in ./src/views/antdemo.less
  Module build failed: ModuleBuildError: Module build failed: TypeError: Cannot read property 'lessLoader' of undefined
      at Object.module.exports (/Users/gxz/workspace_js/react-demo/node_modules/less-loader/index.js:50:18)
      at runLoaders (/Users/gxz/workspace_js/react-demo/node_modules/webpack/lib/NormalModule.js:244:20)
      at /Users/gxz/workspace_js/react-demo/node_modules/loader-runner/lib/LoaderRunner.js:364:11
      at /Users/gxz/workspace_js/react-demo/node_modules/loader-runner/lib/LoaderRunner.js:230:18
      at runSyncOrAsync (/Users/gxz/workspace_js/react-demo/node_modules/loader-runner/lib/LoaderRunner.js:143:3)
      at iterateNormalLoaders (/Users/gxz/workspace_js/react-demo/node_modules/loader-runner/lib/LoaderRunner.js:229:2)
      at Array.<anonymous> (/Users/gxz/workspace_js/react-demo/node_modules/loader-runner/lib/LoaderRunner.js:202:4)
      at Storage.finished (/Users/gxz/workspace_js/react-demo/node_modules/enhanced-resolve/lib/CachedInputFileSystem.js:43:16)
      at provider (/Users/gxz/workspace_js/react-demo/node_modules/enhanced-resolve/lib/CachedInputFileSystem.js:79:9)
      at /Users/gxz/workspace_js/react-demo/node_modules/graceful-fs/graceful-fs.js:78:16
      at FSReqWrap.readFileAfterClose [as oncomplete] (fs.js:532:3)
  @ ./src/views/antddemo.js 44:0-25
  @ ./src/routes/antd.js
  @ ./src/routes/index.js

  解决办法：升级 less 和 less-loader