安装Vite+Svelte依赖时esbuild@0.17.12 postinstall脚本语法错误求助

问题描述 #

我在VSCode中执行npm install以安装Vite和Svelte相关依赖时，出现如下错误：

esbuild@0.17.12 postinstall C:\Users\smurf\Data Visualisation\javascript\datavis-main\node_modules\esbuild
node install.js
SyntaxError: Unexpected token {
at createScript (vm.js:80:10)
at Object.runInThisContext (vm.js:139:10)
at Module._compile (module.js:617:28)
at Object.Module._extensions..js (module.js:664:10)
at Module.load (module.js:566:32)
at tryModuleLoad (module.js:506:12)
at Function.Module._load (module.js:498:3)
at Function.Module.runMain (module.js:694:10)
at startup (bootstrap_node.js:204:16)
at bootstrap_node.js:625:3

随后出现大量npm WARN信息，最终报错如下：

npm ERR! code ELIFECYCLE
npm ERR! errno 1
npm ERR! esbuild@0.17.12 postinstall: `node install.js`
npm ERR! Exit status 1
npm ERR!
npm ERR! Failed at the esbuild@0.17.12 postinstall script.
npm ERR! This is probably not a problem with npm. There is likely additional logging output above.

我是JavaScript新手，已经尝试过手动单独安装esbuild（npm install esbuild），但不知后续该如何处理，恳请帮助。

解决方案 #

核心原因 #

esbuild@0.17.12要求Node.js版本至少为14.14.0，你当前使用的Node.js版本过低，不支持脚本里的ES语法（比如解构赋值{}），导致执行install.js时抛出语法错误。

具体解决步骤 #

• 1. 检查当前Node.js版本
  打开终端执行命令：

  node -v
  

  若输出的版本号低于14.14.0，必须进行升级。

• 2. 升级Node.js
  下载并安装Node.js的LTS版本（推荐18.x或20.x系列），安装完成后重启终端，再次执行node -v确认版本达标。

• 3. 清理旧依赖并重新安装

  1. 删除项目目录下的node_modules文件夹和package-lock.json文件
  2. 执行命令清理npm缓存：

     npm cache clean --force
     

  3. 重新运行安装命令：

     npm install
     

备选方案（不推荐） #

如果暂时无法升级Node.js，可以锁定esbuild到兼容旧版本的版本（比如0.16.x），执行命令：

npm install esbuild@0.16.17 --save-dev

之后再执行npm install，但这种方法可能引发Vite/Svelte与esbuild的版本冲突，优先推荐升级Node.js。

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