在macOS Catalina执行npm create vite@latest project出现模块错误

这个错误的核心原因是macOS Catalina预装的Node.js版本过低（通常是v12.x），不支持Vite最新版本中使用的ES模块语法（比如import fs from 'node:fs'这种带前缀的导入方式）。Vite当前最新版本要求Node.js至少为v14.18.0、v16.0.0或更高版本。

解决步骤： #

• 清理系统自带的旧版本Node.js（避免版本冲突）
  执行以下命令：

  sudo rm -rf /usr/local/bin/node
  sudo rm -rf /usr/local/lib/node_modules/npm
  

• 安装nvm（Node版本管理器）
  用curl安装nvm：

  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
  

  安装完成后，重启终端，或者执行以下命令让nvm立即生效：

  # Bash用户
  source ~/.bash_profile
  # Zsh用户
  source ~/.zshrc
  

• 安装兼容Vite的Node.js版本
  安装稳定的LTS版本（比如v18.x）：

  nvm install 18
  nvm use 18
  

  若要设置为默认版本，执行：

  nvm alias default 18
  

• 重新执行Vite项目创建命令

  npm create vite@latest project
  

替代方案（不升级Node）： #

如果暂时不想升级Node.js，可以指定安装兼容v12的旧版Vite，比如Vite 4.x系列：

npm create vite@4 project

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