Vue / 系统课时
认识开发与生产环境
认识开发与生产环境
Vue 3 项目里,“开发”和“生产”不只是启动命令不同,还会影响模式、环境变量来源、代码替换方式和最终构建产物。本节用 Vite 的默认机制把这几层关系拆开,并给出一套可验证的环境配置方式。
学习目标
- 区分运行模式、环境变量、开发服务器和生产构建产物
- 掌握
.env系列文件的加载优先级与VITE_暴露规则 - 能分别启动开发模式和生成生产构建,并验证配置是否生效
把模式、变量与构建产物分开
Vite 的 mode 是一次启动或构建使用的配置名称。vite 默认使用 development,vite build 默认使用 production,也可以通过 --mode 改成 staging 等自定义名称。模式决定会额外加载哪一组 .env.[mode] 文件,但它本身不等于“服务器环境”。
环境变量是构建工具读入的键值。前端源码只能通过 import.meta.env 访问被 Vite 暴露的变量;默认只有以 VITE_ 开头的自定义变量会进入客户端代码。生产构建时,这些值会被写入静态产物,因此不能把密码、私钥或数据库凭据放进 VITE_ 变量。
开发服务器负责按需转换模块并提供热更新;生产构建则把源码编译、压缩并输出到 dist。浏览器最终拿到的是构建后的静态资源,而不是服务器上的 .env 文件。

理解环境文件的加载规则
一个常见项目会同时存在 .env、.env.local、.env.development 和 .env.production。同名变量发生冲突时,可以按“越具体优先级越高”理解:启动进程中已经存在的环境变量最高,其次是 .env.[mode].local、.env.[mode]、.env.local,最后是 .env。
.env.local 与 .env.[mode].local 通常用于本机差异,并应加入 Git 忽略。团队共享的开发或生产默认值则可以放在对应的 .env.[mode] 文件中,但即使文件不提交,凡是通过 VITE_ 暴露给浏览器的值都不能视为秘密。
下面给开发和生产各准备一组公开配置。它们是配置文件示例,不是 Shell 命令。
# .env.development
VITE_API_BASE_URL=http://localhost:3000
VITE_APP_NAME="Enterprise Console Dev"# .env.production
VITE_API_BASE_URL=https://api.example.com
VITE_APP_NAME="Enterprise Console"这两个文件会分别在 development 与 production 模式下参与加载。验证时应读取 import.meta.env.MODE 与自定义变量,而不是在业务代码里自行判断文件名。
在代码中读取并验证配置
在一个已经创建好的 Vite + Vue 3 项目中,可暂时将 src/main.ts 改成下面的最小示例。代码直接显示当前模式和 API 地址,同时在浏览器控制台打印同样的信息。
import { createApp, h } from 'vue';
const mode = import.meta.env.MODE;
const apiBaseUrl = import.meta.env.VITE_API_BASE_URL;
console.log({ mode, apiBaseUrl });
createApp({
render: () => h('main', `${mode}: ${apiBaseUrl}`),
}).mount('#app');使用开发模式启动:
npm run dev -- --mode development预期输出中会出现本地开发地址,端口与启动耗时可能不同:
VITE v<VALUE> ready in <TIME>
Local: http://localhost:<PORT>/打开页面后,正文应显示类似结果:
development: http://localhost:3000接着执行生产构建:
npm run build -- --mode production预期结果是生成 dist 目录,资源文件名通常包含哈希,因此实际 <ID> 会不同:
dist/index.html
dist/assets/index-<ID>.js避免把运行时配置误当成构建时配置
import.meta.env.VITE_API_BASE_URL 在生产构建阶段就会被替换进静态资源。把同一份 dist 上传到两台服务器后,再修改服务器上的 .env.production,已经生成的 JavaScript 不会自动变化;要么重新构建,要么另行设计运行时配置注入机制。
判断环境问题时,先确认当前 mode,再确认实际加载的变量,最后确认正在运行的是开发服务器还是某次历史构建产物。把这三层分开,通常就能快速解释“本地正常、生产不生效”一类配置差异。