Vite 构建原理与配置实践

Vite 的核心思路是「开发时不打包,生产时用 Rollup 打包」,把冷启动时间从秒级降到毫秒级。

开发与生产的差异

  • 开发环境:浏览器原生 ESM 按需请求模块,Vite 只做即时转换
  • 生产环境:Rollup 打包、压缩、分包,输出静态资源
  • 依赖预构建:把 CommonJS / 深层依赖转成 ESM,并合并请求

这解释了一个常见现象:开发时很快,但生产构建慢,两者走的是不同链路。

基础配置

import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'

export default defineConfig({
  plugins: [vue()],
  resolve: {
    alias: { '@': '/src' }
  },
  server: {
    port: 5173,
    host: true
  },
  build: {
    sourcemap: false,
    target: 'es2020'
  }
})

环境变量

  • 只有以 VITE_ 开头的变量会暴露给客户端
  • .env.development / .env.production 按模式加载
  • 敏感密钥不要放在 VITE_ 变量中
const baseURL = import.meta.env.VITE_API_BASE_URL ?? ''

分包策略

build: {
  rollupOptions: {
    output: {
      manualChunks: {
        vendor: ['vue', 'vue-router', 'pinia'],
        ui: ['tdesign-vue-next']
      }
    }
  }
}

分包的目标是:

  • 首屏只加载必要代码
  • 公共依赖单独缓存
  • 避免重复打包同一库

注意:SSR 构建中不要对会被外部化的模块配置 manualChunks。

静态资源

  • public/:原样复制,不做哈希
  • src/assets/:经构建处理,带内容哈希
  • 小文件可内联为 base64,大文件走独立请求
import cover from '@/assets/cover.png'

常见问题

  1. 依赖预构建不一致:清空 node_modules/.vite 后重试
  2. CSS 顺序变化:注意 @import 与组件样式的引入顺序
  3. 生产环境白屏:检查 base 配置与静态资源路径
  4. 本地代理失效:确认 server.proxy 的 changeOrigin 与重写规则
  5. 包体积过大:用构建产物分析插件定位大依赖

实践建议

  • 配置按环境拆分,避免一份配置里堆满条件分支
  • 构建产物纳入 CI 检查,关注体积变化
  • 升级 Vite 大版本时先看迁移指南与插件兼容性