如何强制项目使用Node.js 14.x并解决可选链语法编译报错？

问题描述 #

我的应用通过npm start或yarn start启动，对应的package.json脚本配置为：

"start": "node scripts/start.js"

该脚本负责启动项目的基础构建流程，但编译时出现语法错误：

./src/components/Something/Something.js
Syntax error: Unexpected token (8:16)

   6 | function testOptionalChaining(id, items) {
   7 |   return filter(items,(item) => {
>  8 |     return item?.id == id
     |                 ^
   9 | })

我本地用nvm管理Node版本，当前版本是v14.19.3，已通过以下命令确认：

❯ npm --version
6.14.17
❯ node -v
v14.19.3

我尝试过以下方法，但都未解决问题：

• 在package.json（注：原提问误写为composer.json）中添加engines配置：

  "engines": {
    "node": ">=14.5.0"
  },
  

• 在.npmrc中设置engine-strict=true，删除node_modules后重新执行npm install
• 更新Dockerfile为FROM node:14-slim AS node，让CI流水线构建项目

更新：换了另一台笔记本测试，在启动脚本中打印Node版本：

console.log(chalk.green('Node version: ' + process.version + '\n'));

输出为Node version: v14.21.3，但错误依然存在。

需要解决可选链语法的编译错误，求帮助。

解决方案 #

问题核心：Node 14.5+原生支持可选链语法，但你的项目构建工具（如Babel、Webpack）未配置对应支持，导致转译时出错。

1. 检查并配置Babel #

如果项目使用Babel转译代码：

• 安装可选链插件：

  npm install @babel/plugin-proposal-optional-chaining --save-dev
  

• 在Babel配置文件（.babelrc/babel.config.json）中启用插件：

  {
    "plugins": ["@babel/plugin-proposal-optional-chaining"]
  }
  

2. 升级Create React App（如果适用） #

如果是Create React App项目，旧版react-scripts默认不支持可选链，需升级：

npm install react-scripts@latest

3. 确认构建流程的Node版本 #

确保scripts/start.js启动的构建进程使用的是正确的Node版本，可在脚本开头添加打印：

console.log('构建进程Node版本:', process.version);

如果发现版本不符，需排查nvm在脚本中的生效问题（比如添加source ~/.nvm/nvm.sh到脚本开头），或Docker容器内的Node版本是否正确。

4. 清理缓存 #

清理可能残留的旧配置缓存：

• 清理npm缓存：npm cache clean --force
• 删除node_modules、package-lock.json/yarn.lock后重新安装依赖
• 清理构建工具缓存（如Webpack缓存，具体看项目配置）

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