用途:在创建或编辑 vite.config.ts、搭建项目配置或设置共享 Vite 选项时使用,帮助避免 defineConfig() 等配置错误。
主要能力:说明配置文件的自动解析顺序(vite.config.js/ts/mjs/mts/cjs/cts);汇总共享选项及类型、默认值和用途,如 root、base、mode、define、plugins、publicDir、cacheDir、logLevel、customLogger、clearScreen、envDir、envPrefix、appType、assetsInclude、future。
关键提醒:不要将 envPrefix 设为空字符串,否则所有环境变量都会通过 import.meta.env 暴露给客户端代码;始终使用 defineConfig() 以获得 TypeScript 智能提示和类型检查;在 define 中设置字符串值时始终使用 JSON.stringify();不要把敏感数据放入 VITE_ 前缀的环境变量。
使用方式:基本配置用 defineConfig({...});需区分 serve 与 build 时用函数导出 defineConfig(({ command, mode, isSsrBuild, isPreview }) => {...});需要异步操作时用异步配置;读取环境变量时使用 loadEnv(mode, process.cwd(), ''),因为配置文件默认无法通过 process.env 获取环境变量。
适用场景:SPA、MPA 或自定义服务器项目(appType 选择);需要按命令或模式定制配置;需要过滤日志或配置转换器(Vite 8+ 使用 oxc,esbuild 在 v8 中已弃用,Vite 6/7 仍用 esbuild)。
限制:具体收费、价格、平台、效果等资料暂未提供。