uni-app怎么获取当前运行的平台环境 uni-app条件编译宏定义使用【详解】
uni-app怎么获取当前运行的平台环境 uni-app条件编译宏定义使用【详解】
免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈
在跨平台开发中，准确判断当前运行环境是绕不开的话题。但很多开发者第一步就走错了方向，把运行时API当成了万能钥匙，结果在真机和模拟器之间反复踩坑。今天，我们就来彻底厘清这个核心问题。
uni.getSystemInfoSync().platform 返回值不可靠
先来看一个常见的误区：试图用 uni.getSystemInfoSync().platform 来判断当前是微信小程序、H5还是App。结果呢？在真机上它可能返回 "ios" 或 "android"，这还算正常；可到了H5环境，它可能返回 "web"；而更让人困惑的是，在小程序平台（比如微信、支付宝）里，它反而可能返回空字符串或者 "devtools"。
这其实不是bug，而是设计如此。这个API返回的是底层运行环境，而非你真正关心的当前编译目标平台。换句话说，它告诉你的是“代码在什么引擎里跑”，而不是“你希望代码为哪个平台服务”。
所以，当你的业务逻辑需要根据平台（是微信小程序？H5？还是App？）走不同分支时，依赖这个运行时API就危险了。正确的做法是什么？答案是：必须使用条件编译。
- 条件编译在编译阶段就剔除了无关代码，最终打包体积更小，且彻底杜绝了运行时兼容风险。
uni.getSystemInfoSync()更适合用来查询屏幕宽高、是否支持振动等设备能力，不适合做平台路由决策。- 特别提醒：在微信开发者工具模拟器里，
platform经常是"devtools"，这和真机行为不一致，极易导致误判。
条件编译宏怎么写才不被忽略
知道了要用条件编译，怎么写才能确保它生效呢？uni-app的条件编译必须写成特定的注释格式，并且要紧贴代码上下文。一个常见的错误是加了多余的空格、误用了双斜杠 //，或者把宏放在了export default外部，导致整个模块被跳过。
来看几个正确写法的示例：
/* #ifdef H5 */
console.log('这是 H5 平台')
/* #endif */
在Vue模板中，同样适用：
记住以下几个关键点：
- 平台宏名必须全大写，且严格匹配官方文档：
H5、MP-WEIXIN、MP-ALIPAY、APP-PLUS、APP-PLUS-NVUE。 - 需要匹配多个平台时，用英文逗号拼接：
/* #ifdef H5,MP-WEIXIN */。 - 否定写法用
#ifndef，例如/* #ifndef APP-PLUS */表示“非App平台”。 - 最重要的一条：宏定义只对紧邻的下一行或多行代码生效，作用域不会跨组件或文件传递。
process.env.NODE_ENV 和 __UNI_MP_VERSION 是啥
除了平台宏，开发中还可能遇到另外两个变量，但它们都不能用于平台判断。
process.env.NODE_ENV 是Node.js的构建环境变量，uni-app编译时会注入。但它只区分 "development"（开发）和 "production"（生产）两种模式，完全不反映任何平台信息。如果误用它来做平台逻辑，你会发现H5和小程序在线上都输出 "production"，导致代码分支错误。
另一个是 __UNI_MP_VERSION，它是uni-app内部注入的常量，仅在小程序平台存在，其值是对应小程序基础库的版本号（例如 "2.7.0"）。但问题在于，它无法区分微信、支付宝等不同的小程序平台——所有小程序环境都会定义这个变量。
- 结论很明确：这两个变量都不能替代条件编译宏。
- 那么，如果非要在运行时动态获取平台名称怎么办？uni-app没有提供这样的全局变量。唯一可靠的方法是：自己利用条件编译，在项目入口处定义一个平台常量。
- 例如，在 main.js 的开头可以这样写：
/* #ifdef H5 */ const PLATFORM = 'h5' /* #endif */ /* #ifdef MP-WEIXIN */ const PLATFORM = 'mp-weixin' /* #endif */
之后，在整个项目中就可以使用这个PLATFORM常量了。
条件编译嵌套和 JS 文件里怎么用
条件编译支持嵌套，但建议深度控制在两层以内，否则代码的可读性会急剧下降。在JS文件中使用条件编译是完全可行的，但有一个关键限制：不能在对象字面量或函数参数内部直接插入宏注释，必须用宏包裹整块代码。
来看一个典型的错误写法：
const config = {
/* #ifdef H5 */
api: 'https://h5.api.com',
/* #endif */
timeout: 10000
}
这会导致语法错误，因为预编译器处理宏之后，可能会破坏JSON的对象结构。