执行npm run build接连出现语法报错 低版本Node兼容性修复指引
npm run build构建触发Node语法兼容报错修复指引 初始报错场景
运行npm run build启动应用构建流程时,控制台抛出如下错误:
/home/markalexa/blog/client/node_modules/react-dev-utils/node_modules/globby/index.js:47 ...taskOptions, ^^^ SyntaxError: Unexpected token ...
- 报错直接定位到
node_modules路径下react-dev-utils依赖的globby模块文件中,使用对象展开运算符(...taskOptions)的代码行,Node运行时无法识别该语法 - 报错对应的核心代码片段:
const generateGlobTasks = (patterns, taskOptions) => { patterns = arrayUnion([].concat(patterns)); assertPatternsInput(patterns); checkCwdOption(taskOptions); const globTasks = []; taskOptions = { ...taskOptions, // 报错触发行 ignore: [], expandDirectories: true }; - 初始环境版本:
- Node:6.11.4
- npm:6.14.11
零散版本升级后的新报错
将Node版本升级到8.6后,再次执行构建命令,抛出新的语法错误:
/home/markalexa/blog/client/node_modules/fs-extra/lib/mkdirs/make-dir.js:85 } catch { ^ SyntaxError: Unexpected token {
可落地的修复步骤
- 先理清版本兼容逻辑:
- Node 6.x 完全不支持对象展开运算符语法,因此会触发第一个
Unexpected token ...报错 - Node 8.6 内置的V8引擎不支持无参数可选catch绑定(
catch {}写法,Node 10+才正式落地该语法支持),因此会触发第二个Unexpected token {报错 - 当前项目用到的
react-dev-utils、新版fs-extra等构建依赖,本身就是面向Node 14+版本开发的,零散升级到8.6根本达不到依赖的语法兼容要求
- Node 6.x 完全不支持对象展开运算符语法,因此会触发第一个
- 清理旧的依赖残留:
执行命令删除项目下的旧依赖目录和锁文件,避免缓存干扰:rm -rf node_modules package-lock.json - 匹配正确的Node版本:
安装Node 16.x长期支持版本,该版本内置的V8引擎完整覆盖对象展开、可选catch等所有前端构建工具常用的ES新语法,不会再出现这类语法识别类报错 - 重装依赖完成构建:
执行npm install重新拉取项目依赖,再运行npm run build即可正常完成构建流程。
内容的提问来源于stack exchange,提问作者wood
相关产品推荐
相关产品推荐

