强制重新预构建

当依赖发生变化或预构建缓存问题时，可强制重新执行预构建。

命令行强制

Bash

# 使用 --force 参数
vite --force

# 或
npm run dev -- --force

清除缓存目录

Bash

# 手动删除缓存
rm -rf node_modules/.vite

# Windows
rmdir /s /q node_modules\.vite

配置强制重建

JavaScript

export default defineConfig({
  optimizeDeps: {
    force: true  // 每次启动都重新预构建
  }
})

缓存位置

Bash

node_modules/.vite/
├── deps/            # 预构建产物
├── _metadata.json   # 依赖元数据

注意：force: true 会显著增加启动时间，不建议长期使用。

自动触发条件

变化	自动重建
package.json 依赖变化	✓
lock 文件变化	✓
vite.config.js optimizeDeps 变化	✓
源码 import 变化	✗

解决预构建问题

JavaScript

# 依赖更新后报错
# 1. 清除缓存
rm -rf node_modules/.vite

# 2. 重新安装依赖
npm install

# 3. 重新启动
npm run dev

开发最佳实践

text

export default defineConfig({
  optimizeDeps: {
    // 开发时不建议开启 force
    // force: false (默认)

    // 明确声明依赖避免问题
    include: ['new-dependency']
  }
})

要点总结

vite --force 强制重建
删除 node_modules/.vite 清缓存
force: true 配置每次重建
依赖变化自动触发重建