Webpack构建失败：依赖不匹配如何解决？大型项目迁移遇报错

看起来你遇到的核心问题是backbone.radio@2.0.0内部依赖了已废弃的Babel 6预设babel-preset-es2015，但你项目中使用的是Babel 7的@babel/preset-env，两者不兼容导致模块找不到的报错。下面是几个常规的解决方案，按优先级排序：

1. 优先升级backbone.radio到最新版本 #

旧版本的backbone.radio可能还停留在Babel 6的生态中，而新版本大概率已经适配了Babel 7的规范。执行以下命令升级：

npm install backbone.radio@latest
# 或者用yarn
yarn add backbone.radio@latest

升级后重新运行Webpack构建，通常能直接解决这个依赖冲突问题。

2. 调整Webpack+Babel配置，兼容旧版本backbone.radio #

如果因为项目限制无法升级backbone.radio，可以通过配置让Webpack正确转译这个依赖包：

步骤一：修改babel-loader的范围 #

默认Webpack不会转译node_modules里的代码，但backbone.radio的源码可能需要用你的Babel 7配置重新转译。在webpack.config.js中调整babel-loader的规则，把backbone.radio排除在exclude之外：

module.exports = {
  // ...其他配置
  module: {
    rules: [
      {
        test: /\.js$/,
        // 排除node_modules，但特例包含backbone.radio
        exclude: /node_modules\/(?!backbone\.radio)/,
        use: {
          loader: 'babel-loader',
          options: {
            presets: ['@babel/preset-env']
          }
        }
      }
    ]
  }
};

步骤二：覆盖backbone.radio的Babel配置 #

如果backbone.radio内部有自己的.babelrc或Babel配置，可能会强制使用babel-preset-es2015。你可以在项目根目录的Babel配置文件（比如babel.config.json或.babelrc）中添加overrides规则，强制给backbone.radio使用你的预设：

{
  "presets": ["@babel/preset-env"],
  "overrides": [
    {
      "test": "./node_modules/backbone.radio",
      "presets": ["@babel/preset-env"]
    }
  ]
}

3. 清理依赖缓存（辅助步骤） #

有时候依赖缓存会导致奇怪的冲突，执行以下命令清理后重新安装：

rm -rf node_modules package-lock.json
npm install

这些步骤应该能解决你当前的构建报错。如果尝试后还有其他问题，通常可以从依赖版本兼容性、Webpack loader的匹配范围、Babel配置的优先级这几个方向继续排查。

内容的提问来源于stack exchange，提问作者Cameron