Vue3如何使用Vite配置环境变量

一、为什么要配置环境变量？

一个前端项目从开发到上线，通常要经历本地开发、自测、测试环境、预上线，最后才是正式发布。这中间每个环境都可能不太一样——比如用户访问资源的权限、服务器地址、接口地址等等。每次切换环境都要手动改一堆配置，不仅麻烦，还容易出错。

那么，怎么优雅地管理这些差异呢？答案就是环境变量和模式。把不同环境的配置抽离出来，代码里只用变量引用，环境一变，自动切换。这才是现代前端工程化的常规操作。

二、在Vite中配置环境变量

1. 环境变量和模式

既然项目是用Vite搭建的，那配置环境变量之前，先得搞清楚Vite里环境变量和模式的概念。

2. 环境变量

Vite把环境变量挂在一个特殊的对象 import.meta.env 上。这里面有几个内置变量，开箱即用：

• import.meta.env.MODE：{string} 应用运行的模式（比如开发、生产）。
• import.meta.env.BASE_URL：{string} 部署应用时的基础 URL，由 base 配置项决定。
• import.meta.env.PROD：{boolean} 是否运行在生产环境。
• import.meta.env.DEV：{boolean} 是否运行在开发环境（与 PROD 相反）。
• import.meta.env.SSR：{boolean} 是否运行在服务端。

3. 生产环境替换

注意，生产构建时，这些环境变量会被静态替换——也就是说，构建工具会直接把变量名替换成实际值。所以引用时一定要用完全静态的字符串，比如 import.meta.env.VITE_SOME_KEY。千万别搞动态拼接，像 import.meta.env[key] 这种写法是无效的。

4. env 文件

在项目根目录下新建两个文件：

.env.dev 文件

NODE_ENV = dev
VITE_NAME="LJY"

.env.pro 文件

NODE_ENV = pro
VITE_NAME="LJY"

Vite 借助 dotenv 从环境目录中加载这些文件。具体加载顺序有优先级，下面详细说。

环境加载优先级

首先，指定模式的文件（比如 .env.production）优先级高于通用文件（比如 .env）。其次，Vite 启动时已经存在的系统环境变量优先级最高，不会被 .env 文件覆盖——比如你在命令行里写了 VITE_SOME_KEY=123 vite build，那这个值就优先。

.env 类文件会在 Vite 启动时一次性加载，修改后必须重启服务器才能生效。加载后的变量会通过 import.meta.env 暴露给客户端源码（全部以字符串形式）。

为了防止意外泄露敏感信息，只有以 VITE_ 开头的变量才会暴露给前端代码。比如下面这两个变量：

VITE_SOME_KEY=123
DB_PASSWORD=foobar

只有 VITE_SOME_KEY 能被 import.meta.env.VITE_SOME_KEY 访问到，DB_PASSWORD 则返回 undefined。

console.log(import.meta.env.VITE_SOME_KEY) // 123
console.log(import.meta.env.DB_PASSWORD) // undefined

如果你想自定义 env 变量的前缀，可以配置 envPrefix 选项。

安全注意事项

• .env.*.local 文件属于本地文件，可能包含敏感信息。建议把 .local 添加到 .gitignore 中，防止被提交到仓库。
• 任何暴露给 Vite 源码的变量最终都会出现在客户端包中，所以 VITE_* 变量里不要放任何敏感数据。

总结

配置环境变量其实并不复杂，核心就是分清模式、利用好 VITE_ 前缀和安全隔离原则。掌握了这些，不同环境之间的切换就不再是头疼的事了。