唯一可靠判断微信小程序运行环境的方式是 uni.getAccountInfoSync().miniProgram.envVersion，其值恒为 "develop"、"trial" 或 "release"，其他方式均不可靠。
uni.getAccountInfoSync().miniProgram.envVersion 是唯一可靠判断依据
微信小程序的运行环境（开发版/体验版/正式版）只能通过 uni.getAccountInfoSync() 的 envVersion 字段判断，其他方式如请求头、__wxConfig、uni.getSystemInfoSync() 都不可靠或已被弃用。这个字段在所有环境（包括开发者工具、真机调试、体验版、正式版）下都稳定返回字符串，且不会因基础库版本或平台差异而缺失。
它有且仅有三个有效值："develop"、"trial"、"release"，分别对应开发版、体验版、正式版。注意：灰度版（"gray"）是支付宝专属，微信不识别，硬判会出错。
-
envVersion永远可取，哪怕在 H5 或 App 端调用也返回undefined，但不会报错——你只需确保它只在MP-WEIXIN平台执行 - 别和
version字段混淆：version仅在envVersion === "release"时有值，开发/体验版为空，不能用来做环境判断 - 该 API 是同步调用，无需
await，也不触发异步回调，直接解构使用即可
为什么不能用 process.env.NODE_ENV 或 uni.getSystemInfoSync().platform
process.env.NODE_ENV 是构建时变量，由 HBuilderX 或 CLI 在编译阶段写死，和当前实际运行的小程序环境完全无关。你在开发者工具里点“运行”，它可能是 "development"；但打包成体验版后上传，它仍是 "development"（除非你手动改了构建配置），根本无法反映“这个包此刻跑在哪个微信环境”。
uni.getSystemInfoSync().platform 返回的是底层运行容器标识，比如 "devtools"（开发者工具）、"android"（安卓微信）、"ios"（iOS 微信），它描述的是设备/模拟器类型，不是你发布的小程序版本状态。用它判断“是不是正式版”等于拿手机型号去猜 App 是否上架应用商店。
- H5 页面中
platform可能是"web"，但你的小程序代码根本没跑在 H5 上 - 鸿蒙设备可能返回空字符串或
"harmony"，导致判断逻辑意外跳过 - 条件编译（如
/* #ifdef MP-WEIXIN */）能保证代码只出现在小程序包里，但不能区分“这个小程序包当前运行在开发版还是正式版”
如何安全封装一个运行时环境判断函数
直接裸用 uni.getAccountInfoSync() 有风险：它在非小程序平台（如 H5、App）会返回 undefined，解构时容易报 Cannot read property 'envVersion' of undefined。必须加平台守卫和容错。
推荐写法：
function getMiniProgramEnv() {
// 先确认是微信小程序平台（编译期 + 运行期双重保险）
if (typeof uni.getAccountInfoSync !== 'function' || !uni.getSystemInfoSync) return null
try {
const info = uni.getAccountInfoSync()
return info?.miniProgram?.envVersion || 'unknown'
} catch {
return 'unknown'
}
}- 调用前先检查
uni.getAccountInfoSync是否存在，避免 H5 环境 crash - 用可选链操作符
?.miniProgram?.envVersion防止中间任意层级为null或undefined - 不要在
main.js顶层立即执行——有些插件或分包可能尚未 ready，建议在App.vue的onLaunch或页面onLoad中首次调用
常见误用场景与线上踩坑点
很多团队在线上监控里发现“正式版用户上报了 envVersion === 'develop'”，其实不是代码问题，而是用户本地缓存了旧版开发者工具预览码，或扫了测试人员生成的开发版二维码。微信不会强制刷新运行环境标识，只要小程序进程没被杀，envVersion 就维持原值。
- 别在登录成功后才判断环境——用户可能已进入首页，此时再切接口域名会导致请求发错地址
- AB 实验分流若依赖
envVersion，需确保实验配置在onLaunch阶段就加载完毕，否则首屏可能漏打标 - 灰度发布期间，正式版用户可能收到新包但仍是
"release"，此时要结合version字段比对是否 >= 目标版本，不能只看envVersion - 真机调试时，如果连的是本地 mock 服务，
envVersion仍是"develop"，但网络请求走的是外网——这种混合环境最容易引发数据污染
真正关键的不是“怎么拿到值”，而是什么时候取、在哪取、取完怎么用。envVersion 看似简单，但它决定了接口地址、埋点开关、错误上报策略甚至 UI 展示逻辑，一旦在分包或 web-view 子页中漏判，整个链路就可能错配。
