npm run start执行异常，疑似webpack版本问题求修复方案

云原生阿岚

2026-7-2

问题

执行npm run start命令时项目抛出异常，项目的package.json配置如下：

{
    "name": "webdiff",
    "version": "0.0.5",
    "scripts": {
        "start": "node ./bin/start",
        "build": "webpack --color --config webpack.config.js",
        "deploy": "npm run build && node writeHtml.js"
    },
    "dependencies": {
        "@babel/core": "^7.3.4",
        "@babel/preset-env": "^7.3.4",
        "antd": "^4.4.2",
        "classnames": "^2.2.6",
        "diff": "^4.0.2",
        "ejs": "^3.1.9",
        "express": "^4.16.4",
        "http-errors": "^1.6.2",
        "morgan": "^1.9.1",
        "react": "^16.8.3",
        "react-dom": "^16.8.3"
    },
    "devDependencies": {
        "@babel/plugin-proposal-class-properties": "^7.8.3",
        "@babel/plugin-proposal-optional-chaining": "^7.10.4",
        "@babel/plugin-transform-runtime": "^7.3.4",
        "@babel/preset-react": "^7.0.0",
        "babel-loader": "^8.0.6",
        "babel-plugin-import": "^1.13.0",
        "css-loader": "^6.9.0",
        "mini-css-extract-plugin": "^0.4.5",
        "source-map-loader": "^1.0.1",
        "webpack": "^5.0.0",
        "webpack-cli": "^3.2.3"
    }
}

从报错信息可判断，核心问题是webpack 5与webpack-cli 3版本不兼容，webpack 5要求搭配webpack-cli 4及以上版本使用。

修复方案

升级webpack-cli到兼容版本
执行以下命令安装适配webpack 5的webpack-cli版本：
```
npm install webpack-cli@^4.0.0 --save-dev
```
也可以直接修改package.json中webpack-cli的版本为^4.0.0，再执行npm install。
降级webpack到适配当前webpack-cli的版本
若不想升级webpack-cli，可将webpack降级到4.x版本：
```
npm install webpack@^4.46.0 --save-dev
```
注：当前mini-css-extract-plugin@^0.4.5兼容webpack 4，无需调整。
额外确认：babel-loader版本兼容
当前babel-loader@8.0.6同时支持webpack 4和5，升级/降级webpack后无需修改该依赖。