1、配置文件解析

当以命令行方式运行 vite 时,Vite 会自动解析 项目根目录下名为 vite.config.js 的文件。最基础的配置文件是这样的:

  1. // vite.config.js
  2. export default {
  3. // 配置选项
  4. }

注意:即使项目没有在 package.json 中开启 type: “module”,Vite 也支持在配置文件中使用 ESM 语法。
这种情况下,配置文件会在被加载前自动进行预处理。

显式地通过 —config 命令行选项指定一个配置文件

  1. vite --config my-config.js

2、配置智能提示

使用 defineConfig 工具函数
Vite 也直接支持 TS 配置文件。你可以在 vite.config.ts 中使用 defineConfig 工具函数。

  1. import { defineConfig } from 'vite'
  2. export default defineConfig({
  3. // ...
  4. })

3、情景配置

如果配置文件需要基于(dev/serve 或 build)命令或者不同的 模式 来决定选项,则可以选择导出这样一个函数:

  1. export default defineConfig(({ command, mode }) => {
  2. if (command === 'serve') {
  3. return {
  4. // dev 独有配置
  5. }
  6. } else {
  7. // command === 'build'
  8. return {
  9. // build 独有配置
  10. }
  11. }
  12. })

需要注意的是,在 Vite 的 API 中,
在开发环境下 command 的值为 serve
(在 CLI 中, vite dev 和 vite serve 是 vite 的别名)
生产环境下为 build(vite build)。

4、异步配置

如果配置需要调用一个异步函数,也可以转而导出一个异步函数

  1. export default defineConfig(async ({ command, mode }) => {
  2. const data = await asyncFunction()
  3. return {
  4. // 构建模式所需的特有配置
  5. }
  6. })