一次create-react-app创建项目升级webpack的流水账-优快云博客

本文详细记录了从旧版Webpack升级到Webpack4的过程，包括解决各种插件兼容性问题，如html-webpack-plugin、eslint-loader等，以及配置调整，如使用mini-css-extract-plugin替代extract-text-webpack-plugin。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

不再赘述为什么要升级webpack4，有兴趣的小伙伴可以看一下知乎：如何评价webpack4

下面撸起袖子开干：

克隆项目，新建分支

git checkout -b feature_webpack_upgrade  
# 相当于以下两句的简写
git branch feature_webpack_upgrade  
git checkout feature_webpack_upgrade  
复制代码

升级webpack

yarn add webpack webpack-dev-server webpack-cli 
复制代码

运行后报错：

Plugin could not be registered at 'html-webpack-plugin-before-html-processing'. Hook was not found. 
复制代码

报错信息表示插件html-webpack-plugin-before-html-processing有问题，然而webpack中并没有这个插件，google之后发现github上有对这个问题的讨论，所以升级插件：

yarn add react-dev-utils html-webpack-plugin 
复制代码

修改配置文件，交换以下两个插件位置：

new HtmlWebpackPlugin({}), 

new InterpolateHtmlPlugin(env.raw), 
复制代码

继续运行，报错

TypeError: Cannot read property 'eslint' of undefined
复制代码

升级eslint即可

yarn add eslint-loader 
复制代码

继续运行，报错：

missingDeps.some not a function
复制代码

这个问题比较棘手，继续google之后找到原因missingDeps.some not a function

yarn add react-dev-utils@6.0.0-next.3e165448 
复制代码

继续运行，报错：

Error: webpack.optimize.UglifyJsPlugin has been removed, please use config.optimization.minimize instead. 
复制代码

干掉被移除的插件UglifyJsPlugin即可，webpack4生产模式下原生支持代码压缩和分割

继续运行，报错：

Chunk.entrypoints: Use Chunks.groupsIterable and filter by instanceof Entrypoint instead 
mini-css-extract-plugin
复制代码

很明显，Entrypoint由mini-css-extract-plugin提供了，查找之下发现Chunk.entrypoints由extract-text-webpack-plugin提供，那么：

yarn remove extract-text-webpack-plugin
yarn add mini-css-extract-plugin
复制代码

继续运行，报错：

Error: Chunk.initial was removed. Use canBeInitial/isOnlyInitial() 
复制代码

升级webpack-manifest-plugin即可。

运行通过，提交代码，PR。

所有问题都可以通过仔细阅读error trace加上善用google搞定。

收工~