import.meta.env.VITE_XXX_URL 是 Vite 项目的环境变量读取语法,用于在构建时获取运行环境配置。
逐段拆解
| 部分 | 含义 |
|---|---|
import.meta |
ES Module 的元信息对象,Vite 在编译时注入 |
.env |
Vite 的环境变量系统 |
VITE_XXX_URL |
自定义的环境变量名,必须以 VITE_ 开头才会暴露给前端 |
它在项目中怎么用
通常在项目根目录的 .env 文件里定义:
# .env 文件(开发环境)
VITE_XXX_URL=http://localhost:8090
# .env.production 文件(生产环境)
VITE_XXX_URL=https://api.yourdomain.com
然后在代码里读取:
// 在 Vue/React 组件或 JS 文件中
const apiBaseUrl = import.meta.env.VITE_XXX_URL
// 发起请求
const response = await fetch(`${apiBaseUrl}/api`)
为什么用 VITE_ 前缀
Vite 为了安全,只暴露以 VITE_ 开头的环境变量给前端代码,防止不小心泄露服务端密钥:
# 会被暴露到前端
VITE_API_URL=http://localhost:3000
VITE_XXX_URL=http://localhost:8090
# 不会暴露到前端(只能在 Node 端使用)
DB_PASSWORD=secret123
API_KEY=sk-xxxx
这样在不同环境下(本地开发 / 测试服务器 / 生产环境)只需修改 .env 文件,不需要改代码。
常见场景
| 环境 | .env 文件 |
VITE_POCKETBASE_URL 值 |
|---|---|---|
| 本地开发 | .env |
http://localhost:8090 |
| 测试环境 | .env.staging |
https://test-api.example.com |
| 生产环境 | .env.production |
https://api.example.com |
一句话
import.meta.env.VITE_XXX_URL= Vite 项目中读取以VITE_开头的环境变量,用于在不同环境下切换后端地址,避免硬编码。
