环境变量
大约 2 分钟开发文档地图
.env文件
Vite 使用 dotenv 从你的 环境目录 中的下列文件加载额外的环境变量:
.env # 所有情况下都会加载
.env.local # 所有情况下都会加载,但会被 git 忽略
.env.[mode] # 只在指定模式下加载
.env.[mode].local # 只在指定模式下加载,但会被 git 忽略
.env.development # 只在开发环境模式下加载
.env.production # 只在生产环境模式下加载
注意
一份用于指定模式的文件(例如 .env.production)会比通用形式的优先级更高(例如 .env)。
另外,Vite 执行时已经存在的环境变量有最高的优先级,不会被 .env 类文件覆盖。例如当运行 VITE_SOME_KEY=123 vite build 的时候。
.env 类文件会在 Vite 启动一开始时被加载,而改动会在重启服务器后生效。 加载的环境变量也会通过 import.meta.env 以字符串形式暴露给客户端源码。
为了防止意外地将一些环境变量泄漏到客户端,只有以 VITE_ 为前缀的变量才会暴露给经过 vite 处理的代码。例如下面这些环境变量:
VITE_SOME_KEY=123
DB_PASSWORD=foobar
只有 VITE_SOME_KEY 会被暴露为 import.meta.env.VITE_SOME_KEY 提供给客户端源码,而 DB_PASSWORD 则不会。
console.log(import.meta.env.VITE_SOME_KEY) // 123
console.log(import.meta.env.DB_PASSWORD) // undefined
配置环境变量
VITE_API_BASE_URL
接口请求的根路径。
当使用useAxios发起的请求使用的url为相对路径时,使用此处配置的url作为根路径。
VITE_NO_TOKEN_REDIRECT_URL
无Token时跳转地址。
当使用useAxios时收到的响应的状态码为401时,页面要强制跳转的地址。
VITE_FILE_PREVIEW_URL
文件访问地址。
当文件上传到服务器时,返回的文件访问地址一般为相对路径。
使用此处配置的url作为文件访问的根路径。
VITE_FILE_UPLOAD_URL
文件上传的接口地址。
VITE_FILE_PREVIEW_SERVICE_URL
文件预览服务地址。
VITE_WEB_SOCKET_URL
websocket地址。
VITE_ARCGIS_202_URL
地图服务访问地址。