拿到这个标题的时候，我盯着屏幕愣了几秒。蓝牙和微信小程序，两个词拆开都熟，合在一起却像道暗号。直到我想起上周帮朋友调试一个智能水杯，手机靠近杯子，小程序自动弹出温度数据，那一刻我才意识到，这玩意儿早就在我们身边了，只是大多数人没察觉。

做蓝牙小程序，第一道坎不是代码，是概念。很多人一听“蓝牙”就想到耳机连接，脑子里全是配对、PIN码那套老黄历。但小程序里的蓝牙走的是BLE，低功耗蓝牙，完全两码事。BLE的设备不会主动弹窗求配对，它就像个默默广播的小电台，你拿手机去“听”它的信号，听到了再决定要不要连。我见过太多新手卡在这一步，拿传统蓝牙的思路去写代码，翻车翻得莫名其妙。

真正动手写代码，你会发现微信官方给的文档像本天书。、、，光看函数名就头大。但你别慌，把这些API捋顺了，核心就三步：初始化蓝牙适配器、扫描周边设备、连上你要的那个。我写了个demo，第一天就在真机上跑通了，秘诀是别光看文档，直接复制官方示例代码改。真机调试比模拟器靠谱一百倍，模拟器上蓝牙压根是摆设。

扫描设备这块有个坑，特别隐蔽。你调用，传个空对象进去，看起来没问题，但实际上一堆设备会涌进来，什么电视、音箱、手环，乱成一锅粥。正确姿势是设置参数，只扫描你关心的服务UUID。这串十六进制字符看着吓人，其实就是设备的“身份证号”。我踩过这个坑，扫描列表刷出三十几个设备，挨个点过去，手都快抽筋了。

连接设备之后，真正的硬仗才开始。BLE通信讲究“服务-特征值”结构，一个设备有多个服务，每个服务里有几个特征值，读写都走特征值。你得先拿到特征值的UUID，才能读写数据。这里有个小技巧，很多设备支持，开启通知后，设备主动往手机推数据，不用你一遍遍去轮询。我调那个智能水杯时，就是靠这个接口实时拿到水温变化的。

数据收发还有个恶心人的细节：协议。蓝牙传输的数据得是ArrayBuffer，不是普通字符串。你往设备发“hello”，得先转成十六进制字节；设备回给你一堆二进制，你得解码成人话。这一块我栽过跟头，发中文直接乱码，后来发现得用转编码。建议你提前写好工具函数，专门处理ArrayBuffer和字符串互转，省得每次手忙脚乱。

小程序上线的路，比你想的坎坷。蓝牙权限要申请，得在里声明，还要在页面里引导用户打开系统蓝牙。iOS和安卓的权限弹窗还不一样，安卓要动态申请位置权限，不然扫不到设备。我第一版提交审核，被拒了三次，理由都是“功能不可用”。后来才明白，审核员用的测试机没开蓝牙，你得在启动页做个判断，蓝牙没开就弹提示，别让页面白屏傻等。

上线之后，还有一堆真机兼容性问题等着你。有些安卓手机扫描不到设备，是因为系统把蓝牙和GPS绑定了，得同时开定位。iPhone倒是稳定，但连接数一多，偶尔会掉线，你得写重连逻辑。我记得有个用户反馈，小米手机连上设备后，小程序一退后台就断，折腾两天，发现是厂商省电策略把蓝牙服务杀了，用加上后台模式才勉强解决。

回头看看这一路，蓝牙小程序开发说白了就是跟不确定性较劲。硬件厂商千奇百怪，系统版本五花八门，你没法靠一套代码通吃天下。但反过来想，正因为门槛不低，这行反而没那么卷。现在市面上做蓝牙小程序的团队不多，你只要熬过前面那段痛苦期，把几个核心坑踩平了，后面就是顺水推舟的事。

写这篇攻略的时候，我那个智能水杯还摆在桌上，蓝色指示灯一闪一闪。它提醒我，技术这东西，看着高大上，拆开了全是细节。蓝牙小程序不例外，从零到上线，没有捷径，但每一步都有迹可循。你踩过的坑，别人也会踩，把这些坑填平，就是一篇好攻略。现在轮到你动手了，别怕报错，报错说明你在前进。