React项目Vercel部署报错：sh: line 1: vite: command not found

可能的原因及解决方案 #

1. 强制Vercel安装所有依赖（包括devDependencies） #

Vercel默认在生产构建时仅安装dependencies，但Vite作为构建工具属于devDependencies，需要调整安装命令：

• 进入Vercel项目的Settings → Build & Development Settings
• 将Install Command修改为：npm install（如果使用yarn则改为yarn install）
• 保存后重新触发部署

2. 在build脚本中用npx调用Vite #

直接修改package.json的build命令，确保从本地node_modules中调用Vite：

"scripts": {
  "dev": "vite",
  "build": "tsc -b && npx vite build",
  "lint": "eslint .",
  "preview": "vite preview"
}

修改后提交代码重新推送，npx会自动查找项目内的Vite可执行文件。

3. 清除Vercel构建缓存 #

旧缓存可能导致依赖未更新：

• 打开Vercel的部署记录页面
• 找到失败的部署，点击Redeploy
• 勾选"Clear build cache"选项后确认重新部署

4. 统一Node.js版本 #

本地与Vercel使用的Node版本不一致可能导致依赖安装异常：

• 在项目根目录新建.nvmrc文件，写入你的本地Node版本（例如20.10.0）
• 提交该文件并推送，Vercel会自动匹配指定版本安装依赖

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