Ubuntu 20.4 VPS上Vite资源构建卡滞问题求助

针对你在VPS上执行npm run build时反复卡在transforming (x): node_modules/path/to/module阶段的问题，可按以下步骤排查解决：

1. 排查VPS资源瓶颈 #

• 执行htop或top命令，实时查看CPU、内存和磁盘IO使用率。Vite构建依赖足够的内存和CPU资源，若VPS内存低于1GB，极易出现进程卡顿。
• 若内存不足，临时添加2GB交换分区缓解：

  sudo fallocate -l 2G /swapfile
  sudo chmod 600 /swapfile
  sudo mkswap /swapfile
  sudo swapon /swapfile
  

2. 同步依赖环境，清理缓存 #

• 跳过npm audit fix，该命令会修改依赖版本，导致本地与VPS依赖不一致。直接上传本地的package-lock.json到VPS，再执行：

  npm cache clean --force
  rm -rf node_modules
  npm install
  

  确保依赖安装完全和本地一致。

3. 降低Vite构建并发数 #

Vite默认的并行构建可能超出VPS资源承载，修改vite.config.js限制并发：

export default defineConfig({
  build: {
    minify: 'terser', // 替换默认的esbuild，降低并发压力
    terserOptions: {
      parallel: false
    }
  },
  optimizeDeps: {
    parallel: false // 关闭依赖预构建并行
  }
})

4. 修复项目目录权限 #

确保当前用户对项目目录拥有完整读写权限，避免因权限阻塞文件操作：

sudo chown -R $USER:$USER /path/to/your/repository

5. 临时禁用安全工具测试 #

部分VPS的防火墙或安全软件可能拦截Node.js的文件操作，临时关闭防火墙验证：

sudo ufw disable

若问题解决，再针对性配置防火墙规则，不要长期关闭。

6. 统一Node.js安装方式 #

即使版本号一致，系统apt安装的Node.js和nvm安装的版本可能存在底层编译差异。建议卸载系统版本后用nvm重新安装：

sudo apt remove nodejs npm -y
# 安装nvm（请从官方渠道获取安装脚本，确保安全）
nvm install [你的Node版本号]
nvm use [你的Node版本号]

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