1、配置文件解析
当以命令行方式运行 vite 时,Vite 会自动解析 项目根目录下名为 vite.config.js 的文件。最基础的配置文件是这样的:
// vite.config.js
export 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 {
// 构建模式所需的特有配置
}
})