import.meta.env.VITE_XXX_URLVite 项目的环境变量读取语法,用于在构建时获取运行环境配置。

逐段拆解

部分 含义
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_ 开头的环境变量,用于在不同环境下切换后端地址,避免硬编码。