uni.scanCode 在真机上没反应需检查平台兼容性：H5端不可用，微信小程序需配置permission，App端需原生支持；扫码后回调需处理success/fail/complete；result格式依scanType而异，须先判断再解析；App端可优化参数提升识别率。
uni.scanCode 在真机上没反应？检查平台兼容性
uni.scanCode 是 uni-app 提供的统一扫码 API，但它在不同平台行为差异很大。H5 端根本不可用（浏览器无硬件访问权限），微信小程序需在 manifest.json 中配置 "mp-weixin" 的 permission 字段，App 端则依赖原生层是否集成 ZXing 或系统相机模块。
- 微信小程序必须在
manifest.json里加：{"mp-weixin": {"permission": {"scope.userCamera": {"desc": "用于扫码"}}}} - App 端 iOS 需开启
NSCameraUsageDescription权限描述；Android 6.0+ 需动态申请android.permission.CAMERA - H5 端调用
uni.scanCode会静默失败，控制台无报错，只返回fail回调 —— 这是最常被忽略的“假成功”场景
扫码后 callback 不触发？注意 success/fail/complete 的执行时机
uni.scanCode 是异步 API，但它的回调不是 Promise，也不支持 await（除非自行封装）。很多人把逻辑全塞进 success，却没处理 fail 或 complete，导致扫码取消、用户拒权、系统中断等情况完全无感知。
-
fail会在用户主动取消、权限拒绝、系统异常时触发，错误码如1002（用户取消）、1003（权限被拒绝） -
complete总是执行，适合做 loading 关闭、按钮状态重置等兜底操作 - 不要依赖
success唯一出口，尤其在 App 端，部分安卓机型扫码后可能直接走complete而不进success
扫码结果里的 result 格式不一致？解析前先看 scanType
不同码类型返回的 result 内容格式不同：二维码通常是纯文本 URL 或 JSON 字符串，而条形码（如 EAN-13）返回的是数字字符串，微信小程序还可能返回带 weapp 字段的小程序码对象。直接 JSON.parse(result) 会炸。
- 务必先读取
res.scanType，常见值："qr"、"bar"、"datamatrix"、"weapp" - 对
weapp类型，要取res.result下的path和extraData，不能直接当 URL 处理 - 条形码结果不含协议头，拼接跳转链接时得自己补
https://，否则uni.navigateTo会失败
App 端扫码卡顿或识别率低？别硬扛默认参数
uni-app 的 uni.scanCode 在 App 端底层调用的是 DCloud 封装的原生模块，默认启用自动对焦和闪光灯检测，但某些低端 Android 机型反而因此卡顿。识别率低往往不是算法问题，而是画面没对准或环境光不足。
- 加
onlyFromCamera: true强制走相机，禁用相册选图（避免用户误点相册后流程断裂） - 设
scanType: ['qr', 'bar']明确限定类型，比默认全开快 200ms 左右 - 真机调试时发现预览框模糊，大概率是没调用
uni.startSensing或相机初始化失败，此时应捕获fail并提示“请检查摄像头权限”
uni.getSystemInfoSync().platform，该降级就降级，比如 H5 改成手动输入框 + 粘贴识别。 
