安装Vite时出现ERR_DLOPEN_FAILED错误，求解决方案

API 探路者

2026-7-3

解决Vite安装时的ERR_DLOPEN_FAILED错误

检查Node.js版本兼容性
Vite要求Node.js版本符合官方规范，优先使用LTS版本（如18.x、20.x）。先执行node -v查看当前版本，若版本过低或过高，前往Node.js官网下载对应LTS版本重装，安装后务必重启终端。
清理Node.js缓存
缓存损坏可能导致安装异常，执行以下命令强制清理缓存：
```
npm cache clean --force
```
清理完成后，重新尝试全局安装Vite：
```
npm install -g vite
```
补充系统依赖
- Windows：确保安装最新系统更新，若使用WSL环境需开启Windows Subsystem for Linux；同时检查是否缺失VC++运行库，安装微软常用运行库合集。
- Linux（Ubuntu/Debian系）：安装必要编译依赖：
```
sudo apt-get install build-essential libssl-dev
```
- macOS：安装Xcode Command Line Tools：
```
xcode-select --install
```
改用本地安装替代全局安装
若全局安装持续报错，可尝试在项目目录内本地安装：
1. 创建并进入项目目录：
```
mkdir my-vite-project && cd my-vite-project
```
2. 初始化项目：
```
npm init -y
```
3. 本地安装Vite：
```
npm install vite --save-dev
```
随后在package.json的scripts中添加启动命令：
```
"scripts": {
  "dev": "vite"
}
```
执行npm run dev即可启动项目。
修复权限问题（Linux/macOS）
全局安装时权限不足也可能触发错误，避免用sudo安装npm包，推荐使用nvm（Node Version Manager）管理Node.js版本与权限，安装nvm后重新部署Node.js和Vite。