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'
常见问题
- 依赖预构建不一致:清空
node_modules/.vite后重试 - CSS 顺序变化:注意
@import与组件样式的引入顺序 - 生产环境白屏:检查
base配置与静态资源路径 - 本地代理失效:确认
server.proxy的changeOrigin与重写规则 - 包体积过大:用构建产物分析插件定位大依赖
实践建议
- 配置按环境拆分,避免一份配置里堆满条件分支
- 构建产物纳入 CI 检查,关注体积变化
- 升级 Vite 大版本时先看迁移指南与插件兼容性