构建Svelte项目时vite build报错：找不到vite-manifest.json文件

以下是针对性的排查和修复步骤：

• 核对Node.js版本兼容性
  Svelte Kit对Node.js版本有明确要求，部分旧版本会导致构建流程异常。执行node -v查看当前版本，确保使用官方推荐的LTS版本（如v18.x或v20.x）。版本不符的话，用nvm（Node版本管理器）切换到兼容版本。

• 彻底清理本地残留文件
  本地依赖或构建缓存的残留可能导致异常，执行以下操作：

  • 删除本地依赖目录：rm -rf node_modules（Windows系统用rmdir /s/q node_modules）
  • 删除Svelte Kit构建缓存：rm -rf .svelte-kit
  • 删除锁文件：rm package-lock.json yarn.lock pnpm-lock.yaml
  • 重新安装依赖：npm install（或yarn install/pnpm install）

• 排查全局Node包损坏
  全局安装的Vite或Svelte相关包可能损坏，执行以下操作：

  • 列出全局已安装包：npm list -g --depth=0
  • 卸载可疑包：npm uninstall -g vite @sveltejs/kit svelte-cli
  • 重新安装最新稳定版：npm install -g vite @sveltejs/kit

• 检查系统权限问题
  文件读写权限不足可能导致Vite无法生成或读取vite-manifest.json：

  • Windows用户：右键终端以管理员身份运行，再执行构建命令
  • Linux/macOS用户：尝试用sudo npm run build执行构建（注意：sudo可能改变node_modules目录权限，后续可执行sudo chown -R $USER:$USER node_modules修复）

• 验证构建配置与命令
  检查package.json中的构建命令是否被篡改，执行cat package.json | grep -A 5 "scripts"（Windows用findstr /C:"scripts" package.json），确认build命令为官方标准的vite build或svelte-kit build（取决于Svelte Kit版本）。同时检查svelte.config.js中是否有自定义构建钩子，是否存在提前清理输出目录的逻辑。

• 检查环境变量设置
  错误的环境变量可能干扰构建流程：

  • 查看当前NODE_ENV：echo $NODE_ENV（Windows用echo %NODE_ENV%）
  • 构建时强制设置生产环境：NODE_ENV=production npm run build（Windows用set NODE_ENV=production && npm run build）

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