运行npm run dev报错求助：vite^5.0.10与Node20.0.0环境下的解决办法

问题根源 #

Node.js 20.0.0作为20.x系列的首个版本，存在部分兼容性bug，和Vite 5.x依赖的底层包（如esbuild）不匹配，导致开发服务启动失败。

可行解决办法 #

• 升级Node.js到稳定版本
  直接升级到Node.js 20.x的后续稳定版本（比如20.10.0及以上）或者18.x LTS版本，就能解决大部分兼容性问题。如果用nvm管理版本，执行以下命令：

  # 安装Node.js 20.x稳定版
  nvm install 20 --lts
  # 切换到该版本
  nvm use 20
  

  也可以直接去Node.js官网下载对应版本安装。

• 降级Vite版本
  要是暂时不想升级Node.js，可将Vite降级到4.x系列（和Node 20.0.0兼容），执行命令：

  npm install vite@^4.5.2 --save-dev
  

  完成后重新执行npm run dev。

• 清除缓存重装依赖
  缓存可能引发异常，按以下步骤操作：

  # 删除依赖文件夹和锁文件
  rm -rf node_modules package-lock.json
  # 重新安装依赖
  npm install
  # 启动服务
  npm run dev
  

内容的提问来源于stack exchange，提问作者Muhammad Masudur Rahman