0

0

uni-app环境变量配置 uni-app如何区分开发和生产环境

煙雲

煙雲

发布时间:2026-03-18 16:36:31

|

957人浏览过

|

来源于php中文网

原创

uni-app 中 process.env.NODE_ENV 总是 development,因其由构建系统编译时静态注入且默认设为 development;应使用 UNI_ 开头的环境变量(如 UNI_API_BASE_URL)并通过 .env 文件配置,在 main.js 或 App.vue 中读取。

uni-app环境变量配置 uni-app如何区分开发和生产环境

uni-app 的 process.env.NODE_ENV 为什么总是 development

因为 uni-app 默认不走 Node.js 环境,process.env 是编译时注入的静态值,不是运行时读取的。你改 webpack 配置或在代码里直接写 process.env.NODE_ENV,大概率不会生效——uni-app 的构建系统(vue-cli-service + @dcloudio/uni-cli-shared)有自己的环境变量注入逻辑。

  • 真正生效的是 UNI_PLATFORM(如 h5mp-weixin)和 UNI_APP_ID 这类预定义变量,它们由 CLI 在编译阶段写死进代码
  • process.env.NODE_ENV 只有在使用 vue.config.js 自定义 webpack 配置并显式配置 DefinePlugin 时才可能被覆盖,但会破坏 HBuilderX 兼容性
  • 推荐做法:别依赖 process.env.NODE_ENV,改用 uni-app 官方支持的 uni.getSystemInfoSync().platform 或更稳妥的编译期变量

如何正确定义和读取自定义环境变量(.env 文件方式)

uni-app 支持标准的 .env.env.development.env.production,但必须满足两个硬条件:变量名以 UNI_ 开头,且只在 main.jsApp.vueonLaunch 等生命周期中通过 process.env 访问。

  • 在项目根目录建 .env.development
    UNI_API_BASE_URL=https://dev.api.com
  • .env.production 中写:
    UNI_API_BASE_URL=https://api.com
  • 变量必须以 UNI_ 开头,否则编译时会被忽略(这是 uni-app 的安全限制)
  • 只能在非 static 目录下的 JS 文件中读取,static 下的 JS 不参与编译,读不到 process.env
  • 注意:HBuilderX 2.7+ 才完整支持多环境 .env 文件,旧版需手动触发「发行」→「原生App-云打包」才会注入

运行时判断开发/生产环境的可靠方式(uni.getSystemInfoSync + 编译条件)

单纯靠 JS 运行时判断不可靠,比如开发者工具里 uni.getSystemInfoSync().platform 返回 devtools,但真机调试时又变成 iosandroid。最稳的组合是:编译期变量兜底 + 运行时特征辅助。

Riffo
Riffo

Riffo是一个免费的文件智能命名和管理工具

下载
  • 优先用编译期变量:process.env.UNI_PLATFORM === 'h5' && process.env.NODE_ENV === 'production' —— 注意这里 NODE_ENV 能用,是因为 CLI 内部已把它映射为 UNI_NODE_ENV 并注入
  • 真机调试时,uni.getSystemInfoSync().environment 在微信小程序里返回 developtrial,可配合判断
  • H5 端可通过 URL 判断:location.hostname === 'localhost' || location.port === '8080',但上线后要记得删掉或加开关
  • 避免用 console.log 输出的有无来判断环境——有些平台(如支付宝小程序)即使在生产环境也会保留部分日志

环境变量在不同平台的兼容性差异(h5 vs mp-weixin vs app-plus

同一套 .env 配置,在不同平台的行为可能不一致。比如 app-plus 的云打包流程会忽略 .env.development,而只认 .env;微信小程序基础库 2.25.0+ 才支持 process.env 注入,低版本直接 undefined

  • h5:完全支持 .env.*,变量在 window.__uniConfig 里也能看到(调试用)
  • mp-weixin:仅支持 UNI_* 前缀变量,且必须在 project.config.jsonsetting.minifiedfalse 时才能在开发者工具里调试到
  • app-plus:云打包时只读取 .env(不区分 development/production),本地打包需在 HBuilderX → 运行 → 运行到手机或模拟器时手动选择「使用当前环境变量」
  • 所有平台都不支持动态修改 process.env,赋值语句会被编译器直接删除

最麻烦的其实是调试阶段:你以为切到了 production,其实只是 HBuilderX 没刷新缓存,或者云打包用了旧的 env 文件。每次改完 .env,务必清空 unpackage 目录再重新发行。

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

202

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

275

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

413

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

233

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

122

2024.05.22

vue.js为什么报错
vue.js为什么报错

vue.js报错的原因:1、语法错误;2、组件使用不当;3、数据绑定问题;4、生命周期钩子使用不当;5、插件或依赖问题;6、路由配置错误;7、异步操作处理不当等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

129

2024.03.11

vue.js插槽有哪些用
vue.js插槽有哪些用

vue.js插槽的作用:1、提高组件的可重用性;2、实现组件的灵活布局;3、实现组件间的数据传递和交互;4、促进组件的解耦和模块化。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

187

2024.03.11

vue.js怎么带参数跳转
vue.js怎么带参数跳转

vue.js带参数跳转的方法:1、定义路由;2、在组件中使用路由参数;3、进行带参数的跳转。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

98

2024.03.11

Python WebSocket实时通信与异步服务开发实践
Python WebSocket实时通信与异步服务开发实践

本专题聚焦 Python 在实时通信场景中的开发实践,系统讲解 WebSocket 协议原理、长连接管理、消息推送机制以及异步服务架构设计。内容包括客户端与服务端通信实现、连接稳定性优化、消息队列集成及高并发处理策略。通过完整案例,帮助开发者构建高效稳定的实时通信系统,适用于聊天应用、实时数据推送等场景。

7

2026.03.18

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号