Vite 依赖预构建失败或卡住怎么排查和修复？

Question

仓乃文 · Accepted Answer

Vite 启动时会自动预构建依赖，但有时预构建失败或卡住，导致开发服务器启动不了。

预构建的作用：
```
1. CommonJS → ESM 转换
2. 减少模块数量（lodash 600+ 模块合并成一个文件）
3. 缓存到 node_modules/.vite/
```

常见问题与修复：
```bash
# 问题 1：预构建失败
# 修复：重新安装依赖
pnpm install

# 问题 2：预构建卡住
# 修复：排除问题包
# vite.config.ts
export default defineConfig({
  optimizeDeps: {
    exclude: ["problematic-package"],
  },
});

# 问题 3：CJS 包报 require is not defined
# 修复：强制包含
export default defineConfig({
  optimizeDeps: {
    include: ["cjs-package"],
  },
});

# 问题 4：依赖更新后还是旧的预构建结果
# 修复：清除缓存
rm -rf node_modules/.vite
# 或强制重新预构建
vite --force
```

补充说明：
- 预构建缓存存放在 node_modules/.vite/
- 依赖不变时不重新构建
- --force 强制重新预构建
- CJS 包需要 include 强制预构建
- 规则：遇到预构建问题先清缓存试试