在 vite 项目中区分开发和生产配置,核心做法是利用 node.js 的 process.env.node_env 环境变量。vite 默认将开发环境设为 development,生产构建设为 production。你可以通过在 vite.config.js 中读取该变量,结合 defineconfig 动态返回不同的配置对象来实现差异化设置。

如何根据环境变量动态切换基础路径和插件
直接回答:通过判断 process.env.NODE_ENV 的值,可以在配置文件中为开发环境和生产环境分别指定不同的 base 路径或启用不同的插件。例如,在生产环境中通常需要将静态资源路径设置为绝对路径或 CDN 地址,而在开发环境中保持相对路径即可。

import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';
export default defineConfig(({ command }) => {
const isProd = process.env.NODE_ENV === 'production';
return {
plugins: [react()],
base: isProd ? '/my-app/' : '/',
build: {
outDir: isProd ? 'dist' : 'dev-dist',
sourcemap: !isProd,
},
server: {
open: true,
port: 3000,
},
};
});
上述代码展示了完整的配置逻辑。当运行 vite 命令时,NODE_ENV 为 development,base 设为 /,源码映射开启;当运行 vite build 时,NODE_ENV 为 production,base 设为 /my-app/,源码映射关闭。这种写法利用了 Vite 配置函数接收 command 参数的特性,但更通用的方式是直接依赖 process.env.NODE_ENV,因为这是 Node.js 标准行为,不依赖 Vite 内部参数传递。
如何在不同环境下配置代理和全局变量
直接回答:开发环境下的 API 代理通常只在 server.proxy 中配置,而生产环境则依赖 Nginx 或后端服务处理跨域。对于全局变量,可以使用 define 选项注入,根据环境不同赋予不同的值,如开发环境使用测试接口地址,生产环境使用正式接口地址。

import { defineConfig } from 'vite';
export default defineConfig({
define: {
__API_URL__: JSON.stringify(
process.env.NODE_ENV === 'production'
? 'https://api.example.com'
: 'http://localhost:8080'
),
},
server: {
proxy: {
'/api': {
target: 'http://localhost:8080',
changeOrigin: true,
},
},
},
});
这段代码演示了如何根据环境注入全局常量 __API_URL__。在开发模式下,它指向本地后端;在生产模式下,它指向远程服务器。同时,server.proxy 仅在开发服务器启动时生效,生产构建不会包含此配置。开发者可以直接在代码中使用 __API_URL__,无需手动判断环境,Vite 会在编译时替换为对应的字符串字面量。
生产构建时如何处理环境变量缺失的问题
直接回答:在生产构建过程中,如果未定义某些关键环境变量,Vite 不会自动报错,而是可能使用默认值或导致运行时错误。最佳实践是在构建脚本中显式设置所有必需的环境变量,或在配置文件中提供明确的 fallback 值,确保生产环境的稳定性。
// package.json scripts
{
"scripts": {
"build": "NODE_ENV=production vite build",
"build:prod":
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











