在 vite 中注入全局变量,最推荐的做法是在 vite.config.js 中使用 define 选项,它会在构建时自动将变量替换为字面量值,无需额外插件。若需处理环境变量,可结合 import.meta.env 或 loadenv 函数读取 .env 文件中的配置并映射到 define 对象中。

Vite define 配置如何映射到代码中
通过 define 配置的键名会直接作为全局标识符存在于模块作用域中,Vite 的预处理器会在编译阶段将其替换为对应的字符串、数字或布尔值。例如配置 VITE_APP_TITLE 后,代码中直接使用 VITE_APP_TITLE 即可获取其值,且该变量不会污染浏览器全局 window 对象,而是被打包进模块内部。

import { defineConfig } from 'vite';
export default defineConfig({
define: {
__APP_VERSION__: JSON.stringify('1.0.0'),
__API_BASE_URL__: JSON.stringify('https://api.example.com')
}
});上述配置中,__APP_VERSION__ 和 __API_BASE_URL__ 会被替换为对应的字符串字面量。注意需要使用 JSON.stringify 来包裹字符串值,以确保生成的 JavaScript 代码语法正确。在源代码中引用这些变量时,直接写变量名即可,无需导入。
立即学习“Java免费学习笔记(深入)”;
如何处理 .env 文件中的环境变量
Vite 默认支持 .env 文件,但只有以 VITE_ 开头的变量才会被暴露给客户端代码。可以通过 loadEnv 方法加载指定环境下的所有变量,并将其合并到 define 配置中,从而实现动态注入。

import { defineConfig, loadEnv } from 'vite';
export default defineConfig(({ mode }) => {
const env = loadEnv(mode, process.cwd(), '');
return {
define: {
__ENV_VAR__: JSON.stringify(env.VITE_CUSTOM_VAR || 'default')
}
};
});在 .env 文件中定义 VITE_CUSTOM_VAR=myvalue,上述配置会读取该值并注入到代码中。如果变量不存在,则使用默认值 'default'。这种方式允许根据运行环境(如 development、production)动态调整注入的变量值。
当 .env 文件中缺少 VITE_ 前缀变量时会发生什么
如果 .env 文件中定义的变量没有 VITE_ 前缀,例如 CUSTOM_VAR=test,则该变量不会被 loadEnv 返回,也不会被注入到 define 中。此时若在代码中尝试访问 CUSTOM_VAR,会导致运行时错误,因为该变量未被定义。必须确保所有需要注入到客户端的变量都加上 VITE_ 前缀,否则它们仅对 Node.js 服务端可用,而不会出现在构建后的前端代码中。


















