uni-app条形码扫描需分平台配置：app端启用barcode模块并声明相机权限，小程序配置scope.usercamera权限，h5端须用@zxing/library自建识别流或对接扫码枪，且结果需按scantype类型分支处理。
uni-app 实现条形码扫描不能只靠 uni.scancode 一句调用就完事——它在 h5 端根本不可用，app 端依赖原生模块是否集成，微信小程序需额外配置权限，且返回结果格式不统一。必须按平台分策略处理。
uni.scanCode 在 App 和小程序中怎么配才不白调用
App 端必须确认 manifest.json 已启用 Barcode 模块，并完成权限声明：
- iOS：在
manifest.json的plus->distribute->apple下添加NSCameraUsageDescription字段，值为中文说明（如“用于扫码识别商品条码”），否则上架被拒 - Android：6.0+ 需运行时申请
android.permission.CAMERA，仅 manifest 声明不够 - 微信小程序：
manifest.json中必须写入{"mp-weixin": {"permission": {"scope.userCamera": {"desc": "用于扫码"}}}}，否则调用直接静默失败
参数上别省略 scanType: ['barCode']，否则某些安卓机型默认只扫二维码；onlyFromCamera: true 可禁用相册选图，避免用户误触。
H5 端扫码必须绕开 uni.scanCode
浏览器无法调用摄像头硬件，uni.scanCode 在 H5 下会直接走 fail 回调且无错误信息，极易误判为“功能正常但没扫到”。真实可用方案只有两个：
- 用
@zxing/library+<video></video>自建识别流：需 HTTPS 环境（本地开发用 Vite 的@vitejs/plugin-basic-ssl启 HTTPS），并手动处理设备选择、帧率控制、解码频率（避免 CPU 过载） - 对接 PDA 扫码枪：把
<input type="text">设为焦点，监听input+keyup.enter，因扫码枪本质是 HID 键盘设备，所有条码以纯文本+回车形式输入
注意：@zxing/library 对 EAN-13、CODE128 支持良好，但对模糊/反光/低对比度条码识别率明显低于原生 SDK，生产环境建议加兜底提示“请保持条码平整、光线充足”。
扫码结果解析前必须判断 scanType 和 result 类型
res.result 不是总能直接当字符串用：
-
res.scanType === 'bar'时，res.result是纯数字字符串（如"6923450654321"），不含校验位说明，需业务层自行校验 -
res.scanType === 'qr'时，内容可能是 URL、JSON 字符串甚至 base64，直接JSON.parse(res.result)会报错 - 微信小程序还可能返回
weapp类型，此时res.result是对象，要取res.result.path和res.result.extraData
务必先做类型判断再分支处理，不要假设所有平台返回结构一致。
App 端识别率低？先关掉 autoFocus 和 torch
不少低端安卓机开启自动对焦或闪光灯检测后，预览卡顿、解码延迟明显。实测关闭可提升首帧识别速度 30% 以上：
- App 端调用
uni.scanCode时，**不要传flash或autoFocus参数**（官方文档未明说，但 DCloud 原生层默认开启） - 如需闪光灯控制，改用
plus.barcode原生 API：barcode.setFlash(!flashOn)，比uni.scanCode更底层、更可控 - 识别失败时别立刻重试，加个 500ms 间隔，避免 ZXing 底层解码器状态冲突
最易被忽略的是：App 端扫码后有时只触发 complete，不进 success 或 fail——这在部分华为/小米定制系统上高频出现，complete 里必须检查 res 是否存在，否则逻辑中断。
