在 vite 项目中,配置文件是一个导出了配置对象的 javascript 或 typescript 文件,通常命名为 vite.config.js。你需要导入 defineconfig 函数来包裹你的配置对象,以确保类型提示和插件系统的正确加载。核心做法是在该文件中导出一个包含 plugins、resolve 等属性的对象,vite 启动时会读取并应用这些设置。

Vite 配置文件的基本结构是什么
基本结构是导入 defineConfig 并导出一个普通对象。这个对象不需要复杂的类或异步逻辑,直接返回键值对即可。最关键的属性是 plugins,用于注册如 Vue 或 React 的官方插件。其他常用属性包括 root 指定项目根目录,base 设置部署路径,以及 server 配置开发服务器选项。这种同步导出的方式让 Vite 能够高效地解析配置。

import { defineConfig } from 'vite';
import vue from '@vitejs/plugin-vue';
export default defineConfig({
plugins: [vue()],
resolve: {
alias: {
'@': '/src'
}
},
server: {
port: 3000,
open: true
}
});
上述代码展示了最基础的配置。导入 @vitejs/plugin-vue 后,将其实例放入 plugins 数组。配置了 resolve.alias 将 @ 映射到 /src 目录。同时设置了开发服务器端口为 3000 并自动打开浏览器。运行 npx vite 时,Vite 会读取此文件并应用这些设置。
立即学习“Java免费学习笔记(深入)”;
如何根据环境动态修改配置
可以通过定义一个接受 env 参数的函数来动态生成配置。Vite 允许导出一个函数而非静态对象,该函数接收两个参数:配置选项和环境变量对象。这在需要根据开发或生产环境切换不同插件或设置时非常有用。例如,在生产环境中禁用某些调试插件,或在开发环境中启用特定的代理规则。这种模式提供了极大的灵活性,允许配置随构建目标变化。

import { defineConfig, loadEnv } from 'vite';
import path from 'path';
export default ({ mode }) => {
const env = loadEnv(mode, process.cwd(), '');
return defineConfig({
plugins: [],
resolve: {
alias: {
'@': path.resolve(__dirname, 'src')
}
},
server: {
proxy: {
'/api': {
target: env.VITE_API_BASE_URL,
changeOrigin: true
}
}
}
});
};
这段代码演示了如何使用 loadEnv 加载环境变量。通过检查 mode 参数,可以区分 development 和 production。示例中使用了 VITE_API_BASE_URL 作为代理目标。注意 resolve.alias 使用了 path.resolve 确保路径绝对化。当运行 npx vite build --mode staging 时,mode 将为 'staging',从而加载对应的 .env.staging 文件中的变量。
配置中的 resolve.alias 具体如何影响模块解析
resolve.alias 允许你为模块路径创建别名,从而简化导入语句并避免相对路径的深层嵌套。当你在代码中使用 import Component from '@/components/Button' 时,Vite 会根据配置将其解析为 /src/components/Button。这不会影响运行时行为,因为 Vite 在构建前已经完成了路径转换。如果别名指向的文件不存在,Vite 会在控制台抛出错误。别名优先级高于 node_modules 中的包名,因此可以覆盖第三方库的默认导出,但需谨慎使用以避免冲突。


















