1、配置文件解析
当以命令行方式运行 vite 时,Vite 会自动解析 项目根目录下名为 vite.config.js 的文件。最基础的配置文件是这样的:
// vite.config.jsexport default {// 配置选项}
注意:即使项目没有在 package.json 中开启 type: “module”,Vite 也支持在配置文件中使用 ESM 语法。
这种情况下,配置文件会在被加载前自动进行预处理。
显式地通过 —config 命令行选项指定一个配置文件
vite --config my-config.js
2、配置智能提示
使用 defineConfig 工具函数
Vite 也直接支持 TS 配置文件。你可以在 vite.config.ts 中使用 defineConfig 工具函数。
import { defineConfig } from 'vite'export default defineConfig({// ...})
3、情景配置
如果配置文件需要基于(dev/serve 或 build)命令或者不同的 模式 来决定选项,则可以选择导出这样一个函数:
export default defineConfig(({ command, mode }) => {if (command === 'serve') {return {// dev 独有配置}} else {// command === 'build'return {// build 独有配置}}})
需要注意的是,在 Vite 的 API 中,
在开发环境下 command 的值为 serve
(在 CLI 中, vite dev 和 vite serve 是 vite 的别名)
生产环境下为 build(vite build)。
4、异步配置
如果配置需要调用一个异步函数,也可以转而导出一个异步函数
export default defineConfig(async ({ command, mode }) => {const data = await asyncFunction()return {// 构建模式所需的特有配置}})
