webpack3向4升级中具体问题及解决办法

据说webpack4同比webpack旧版本构建速度提示至少一倍,于是开始webpack升级的尝试。

webpack4已经出来很长时间了,手头有一个基于webpack3的微信公众号项目,在项目的空档期自己在一个开发分支上做了webpack3向4的迁移。

  首先将webpack升级到了4.28.2版本,因为线上项目基于webpack3的版本且为全局安装,不要求升级而且很稳定,项目也不是很重,所以在这个分支惊进行了局部安装(tip看到有的童鞋说webpack的版本冲突的问题,就是升级了webpack之后,为什么在终端查看webpack版本的时候还是全局的,即为升级的版本。这个问题的解决方法是全局安装高版本的webpack,但是如何遇到像我这样的情况,不需要全局安装,那你就局部安装,虽然输出的是低版本,但是运行的是node_modules里面的webpack版本,效果如图

 

。安装的方法可以升级也可以安装具体的版本。

  webpack4将webpack-cli进行了分离,所以需要单独安装。命令行代码:npm i -D webpack-cli

  最基础的两个依赖安装完毕,如果你对webpack4更新之后的一些配置的更新很熟悉的话,可以直接进行配置。否则,你可以跑一下自己的项目,终端会报相应的错误,你可以针对性的进行版本迁移。npm run dev的项目可以直接在本地跑起来,当你想看本地build的项目的时候,需要将项目扔到服务器上,这就是为什么你运行了npm run build之后会出现这样的提示

我将我的项目利用nginx代理放到了服务器上,顺利的跑了起来。这样我们在进行升级到时候就可以同时升级开发和生产环境。

一、以下是我在升级到时候终端报错,及对应的解决办法:

Tapable.plugin is deprecated. Use new API on `.hooks` instead 

  问题原因

  extract-text-webpack-plugin目前版本不支持webpack4。

  解决方案

  使用extract-text-webpack-plugin的最新的beta版

  npm install extract-text-webpack-plugin@next 

  不在维护extract-text-webpack-plugin ,使用mini-css-extract-plugin来提取css 

Module build failed: TypeError: Cannot read property 'vue' of undefined

  解决方案

  Sorry, I forgot update vue-loader@latest

  npm install vue-loader@14.2.2

箭头函数报错:

  在.bablerc文件中presets的参数配置

  {

    "presets": [

      "es2015",

      "stage-1"

    ],

    "env": {

      "modules": false,  

      "targets": {

        "browsers": ["> 1%", "last 2 versions", "not ie <= 8"]

      },

      "start": {

        "presets": [

          "react-hmre"

        ]

      }

    },

    "plugins": ["transform-vue-jsx", "transform-runtime",

     ["component", [

        {

          "libraryName": "mint-ui",

          "style": true

        }

      ]]]

  }

Vue使用webpack:No parser and no file path given, couldn't infer a parser.

  问题出在prettier。

  解决方案

  vue-loader@13.7.2 和vue-loader@14.2.3是已经修复了,等待发布新版可以解决

  npm install prettier@1.12.1 --save-dev

TypeError: compilation.mainTemplate.applyPluginsWaterfall is not a function

  解决方案

  npm install --save-dev html-webpack-plugin@next

vue-loader was used without the corresponding plugin. Make sure to include VueLoaderPlugin in your webpack config.

  解决方案

  在webpack.config.js里面

  const VueLoaderPlugin = require('vue-loader/lib/plugin');

  plugin配置里面:new VueLoaderPlugin()

 

Module parse failed: Unexpected character '@' (286:2)

You may need an appropriate loader to handle this file type.

  解决方案  *而且loader的顺序要保持为下方的顺序,loader的顺序为从右到左

  {

    test: /\.css$/,

    use: ['style-loader','css-loader'],

  } 

Unhandled rejection Error: "dependency" is not a valid chunk sort mode at HtmlWebpackPlugin.sortEntryChunks 

   解决方案

   chunksSortMode: 'none‘

 building for production...CssSyntaxError {

  name: 'CssSyntaxError',

  reason: 'Unknown word',

}

   解决方案

   vue-loader 必须有vueLoaderConfig

  配置选项

  use: [{

    loader: 'vue-loader',

    options: vueLoaderConfig

  }],

二、以下是版本升级之后需要注意的地方:

 1.vue将style重复打包,将

{

  test: /\.scss$/,

  use: ["style-loader", "css-loader", "sass-loader"]

}

, {

  test: /\.css$/,

  use: ['style-loader', MiniCssExtractPlugin.loader, 'css-loader'],

}

, {

  test: /\.styl$/,

  use: [

    {

      loader: 'style-loader!css-loader',

      options: {

        minimize: true

      }

    },

    'postcss-loader', 'stylus-loader'

  ]

}

, {

  test: /\.ts$/, use: 'ts-loader'

}

这部分rules从webpack.base.conf.js放到webpack.prod.conf.js里面

2.移除CommonsChunkPlugin,用optimization.splitChunks和optimization.runtimeChunk来代替

3添加mode参数

4移除loaders使用rules

5处理css的loader里面要use  MiniCssExtractPlugin.loader并且MiniCssExtractPlugin.loader的顺序必须在css-loader之前在style-loader之后

 三、以下是做的一些优化之后遇到的问题及解决办法

******file-loader和url-loader的区别是file-loader生成相应的文件并在目录中显示,url-loader生成base64编码不在项目中显示——性能比较:file-loader生成的项目为534k,url-loader生成的项目为550k(临时数据)

 

*******static中的静态资源不参与到打包当中,适用于经常变更的资源,webpakc将static中的资源直接copy到打包项目中

 

*******要看本地build之后的项目,要将本地的项目扔到服务器上,可以配置一个nginx代理,代理到本地的build之后的代码路径,然后将本地的build的assetsPublicPath的值换做”./”防止找不到路径,之后就可以访问本地的打包之后的效果了

 

*******路由懒加载之后报错:emitting HtmlWebpackPlugin/Users/payplus/Desktop/workspace/webpack3-4-test/jcbs-web/src/main/webapp/jcbs-w/node_modules/toposort/index.js:35

      throw new Error('Cyclic dependency' + nodeRep)

更新html-webpack-plugin的版本npm i --save-dev html-webpack-plugin@next解决了问题

 

对于webpack4的“零配置”个人还是喜欢创建一个webpack.conf.js来进行一些配置的,webpack也是这么做的,允许开发者自主配置,零配置是为了方便开发者但是只提供相应的api而不懂其中的原理和流程是不利于开发者成长的,纯粹看官方文档和一些博客上面的迁移操作也许达不到自己的需求,毕竟当你不进行升级操作的时候,所有的案例都读得懂,但是当你升级了webpack之后终端一片夕阳红的时候,可能会觉得无从下手,希望本文能给你提供一些常见报错的解决思路或方法,如有其它的相关问题欢迎讨论。

posted @ 2019-01-08 14:13  kimsaerono  阅读(3791)  评论(0编辑  收藏  举报