Vite 提供了多种配置方式来满足不同项目的需求。以下是 Vite 配置的详细说明:
配置文件:
Vite 会自动从以下位置加载配置文件(按优先级排序):
vite.config.jsvite.config.mjsvite.config.tsvite.config.cjs
基本配置结构:
javascriptimport { defineConfig } from 'vite' import react from '@vitejs/plugin-react' export default defineConfig({ plugins: [react()], server: { port: 3000, open: true }, build: { outDir: 'dist', sourcemap: true } })
常用配置选项:
开发服务器配置(server):
port:指定开发服务器端口host:指定服务器主机名open:启动时自动打开浏览器proxy:配置代理,解决跨域问题cors:配置 CORS 策略https:启用 HTTPS
构建配置(build):
outDir:输出目录assetsDir:静态资源目录sourcemap:是否生成 source mapminify:压缩方式(terser、esbuild)target:构建目标浏览器rollupOptions:Rollup 配置选项chunkSizeWarningLimit:chunk 大小警告阈值
路径别名(resolve.alias):
javascriptresolve: { alias: { '@': '/src', '@components': '/src/components' } }
CSS 配置(css):
preprocessorOptions:预处理器选项modules:CSS Modules 配置postcss:PostCSS 配置
依赖优化配置(optimizeDeps):
include:强制包含的依赖exclude:排除的依赖esbuildOptions:esbuild 选项
环境变量:
Vite 支持通过 .env 文件配置环境变量:
.env:所有环境.env.development:开发环境.env.production:生产环境.env.local:本地覆盖
环境变量必须以 VITE_ 开头才能在客户端代码中访问。
条件配置:
javascriptexport default defineConfig(({ command, mode }) => { if (command === 'serve') { return { /* dev config */ } } else { return { /* build config */ } } })
TypeScript 支持:
使用 defineConfig 可以获得完整的类型提示和智能补全。