CRA迁移Vite后执行build遇node_modules严格模式语法错误求助

安全阿岳

2026-7-18

解决Vite构建时子依赖的'use strict'语法错误

问题根源

ES5规范禁止在带有非简单参数列表（比如参数解构、默认参数）的函数内部使用"use strict"指令，Vite的CommonJS解析器严格遵循该规范，因此触发报错。

解决方案

1. 定位问题依赖包

首先要找到抛出错误的具体子依赖：

如果报错信息里包含完整文件路径，直接查看路径对应的包名；
没有路径的话，执行npm ls或yarn why排查可疑依赖，比如结合报错里的日期2023-05-11搜索相关包的版本发布记录。

2. 配置Vite强制转译该依赖

在vite.config.js中添加以下配置，让Vite正确转译问题依赖：

export default {
  build: {
    commonjsOptions: {
      // 包含问题依赖包，强制Vite处理它的CommonJS语法
      include: ['问题依赖包名', /node_modules/]
    }
  },
  optimizeDeps: {
    // 预构建时处理该依赖
    include: ['问题依赖包名']
  }
}

3. 给依赖打补丁（patch-package）

如果无法升级/降级依赖，直接修改问题代码并生成补丁：

安装patch-package：
```
npm install patch-package --save-dev
```
找到问题依赖的对应文件，将函数内的"use strict"移到函数外部，或者修改参数列表（比如把function({}, factory)改成function(options, factory)，再在函数内部const {} = options）；
生成补丁：
```
npx patch-package 问题依赖包名
```
将生成的patches/目录提交到版本控制，后续安装依赖时会自动应用补丁。