执行npm run dev提示‘vite: command not found’的解决求助

1. 确认package.json依赖与脚本配置 #

打开项目根目录的package.json，检查两处关键配置：

• 查看devDependencies中是否存在vite依赖（格式类似"vite": "^4.4.5"），如果缺失，手动执行安装：

npm install vite --save-dev

• 确认scripts里的dev命令是"dev": "vite"，无拼写错误

2. 用npx调用本地vite #

如果本地vite已安装但系统无法识别，直接通过npx调用项目内的vite：

• 修改package.json的脚本：

"scripts": {
  "dev": "npx vite"
}

• 或者直接在终端执行：

npx vite

3. 检查npm路径权限与环境变量 #

• 查看npm全局前缀路径：

npm config get prefix

确认该路径下的bin目录（如mac下的/usr/local/bin或用户主目录.npm/bin）在系统PATH中，执行echo $PATH可查看当前PATH。若不在，临时添加路径：

export PATH=$(npm config get prefix)/bin:$PATH

也可将这条命令写入~/.bashrc或~/.zshrc实现永久生效

• 修复项目目录权限，避免安装时隐性失败：

sudo chown -R $USER:$USER ./node_modules

4. 切换依赖管理工具或npm源 #

• 切换淘宝npm源后重新安装：

npm config set registry https://registry.npmmirror.com/
rm -rf node_modules package-lock.json
npm install

• 换用yarn或pnpm尝试安装并启动：

# yarn
yarn install
yarn dev

# pnpm
pnpm install
pnpm dev

5. 验证Node.js版本兼容性 #

vite对Node.js版本有要求（如vite4需要14.18+、16+版本），执行node -v查看当前版本，若版本过低，升级到符合要求的LTS版本（如18.x或20.x）

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