uni-app 的 process.env.NODE_ENV 总是 development，因其为编译时静态注入的默认值，非运行时读取；HBuilderX 下“运行”和“发行”均不自动切换为 production，真正可靠的是 UNI_ 开头的预定义变量。
process.env.NODE_ENV 为什么总是 development
因为 uni-app 的 process.env.NODE_ENV 是编译时静态注入的，默认值就是 'development'，不是运行时读取的 Node.js 环境变量。你在代码里手动改、或者在 webpack 配置里覆盖它，大概率不生效——uni-app 的构建系统（@dcloudio/uni-cli-shared）有自己的注入逻辑，且 HBuilderX 会忽略非标准配置。
更关键的是：即使你用 vue.config.js + DefinePlugin 强行覆盖，也会破坏 HBuilderX 兼容性，导致「运行」菜单异常或发行失败。
-
process.env.NODE_ENV在 HBuilderX 点「运行」时是'development'，点「发行」时仍是'development'（不是'production'） - 真正可靠的是
UNI_PLATFORM、UNI_APP_ID这类预定义变量，它们由 CLI 编译阶段写死进代码 - 自定义变量必须以
UNI_开头，否则会被构建系统直接过滤掉
.env 文件怎么写才生效
根目录下建 .env.development 和 .env.production 是可行的，但必须满足三个硬条件，缺一不可：
- 变量名必须以
UNI_开头，比如UNI_API_BASE_URL；写成VUE_APP_API_URL或API_URL会被忽略 - 只能在
main.js或App.vue的onLaunch等生命周期里读取；static/目录下的 JS 不参与编译，读不到process.env - HBuilderX 版本需 ≥ 2.7，旧版只在「原生App-云打包」时才注入，H5 或小程序本地运行可能拿不到
示例：.env.development 内容：
UNI_API_BASE_URL=https://dev.api.com UNI_WS_URL=wss://dev-ws.example.com
.env.production 内容：
UNI_API_BASE_URL=https://api.com UNI_WS_URL=wss://ws.example.com
如何在代码里安全读取环境变量
别在任意位置直接用 process.env.UNI_API_BASE_URL —— 它可能为 undefined（尤其在 utils/ 或 api/ 模块里），因为 uni-app 对 process.env 的注入有作用域限制。
- 统一在
main.js里做一次提取并挂载到全局属性，比如：const apiBase = process.env.UNI_API_BASE_URL || 'https://fallback.com' - 然后通过
app.config.globalProperties.$apiBase = apiBase（Vue3）或Vue.prototype.$apiBase = apiBase（Vue2）暴露出去 - 避免在
onLoad或异步回调里首次访问process.env，此时变量可能还未注入完成 - 真机调试时，微信开发者工具返回的
uni.getSystemInfoSync().environment是'develop'或'trial'，可作为辅助判断，但不能替代编译期变量
多环境（测试/预发/生产）怎么加
如果只有开发和生产不够用，得加测试环境，推荐用 package.json 配置方式，兼容性最好、HBuilderX 原生支持：
- 在
package.json的uni-app.scripts下新增一个字段，比如："test"，里面写"env"对象 - 所有变量仍必须以
UNI_开头，例如："UNI_API_BASE_URL": "https://test.api.com" - 配置完后，HBuilderX 的「运行」和「发行」下拉菜单会自动出现「测试环境」选项，点击即可编译对应环境
- 注意：手机模拟器不支持切换环境，它固定走开发环境；真机调试时，只有通过「发行」生成的包才带测试环境变量
复杂点在于，不同平台（H5 / 微信小程序 / App）对环境变量的注入时机和作用域不一致，尤其是 UNI_PLATFORM === 'mp-weixin' 时，process.env 在某些生命周期里不可用。最稳的做法是：所有环境相关逻辑，都收口到 main.js 初始化阶段完成判断和赋值，后续代码只读全局变量，不碰 process.env。
