macos 无原生 ble 配对命令,但可用 blueutil 实现连接、断开、忽略等操作;需通过 homebrew 安装并授权终端访问蓝牙权限,扫描用 --inquiry,配对设备管理用 --paired/--connect/--disconnect/--forget。
macos 本身不提供原生终端命令直接管理 ble 设备的配对(如添加、删除、信任等),但可通过 blueutil 工具实现对已知 ble 设备的连接、断开、忽略等关键操作。它作用于系统蓝牙协议栈底层,适用于调试、自动化或图形界面失效时的快速干预。
安装并配置 blueutil
该工具需手动安装,并依赖系统权限才能访问蓝牙服务:
- 若未安装 Homebrew,先运行:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 安装 blueutil:
brew install blueutil - 首次运行任意 blueutil 命令(如
blueutil --power)后,系统会弹出提示;需前往系统设置 → 隐私与安全性 → 辅助功能,勾选你使用的终端应用(如 Terminal 或 iTerm)
查看和识别 BLE 设备
BLE 设备通常以广播方式被发现,blueutil 支持扫描与配对状态查询:
- 扫描附近可发现的设备(含 BLE):
blueutil --inquiry—— 输出包括设备名、MAC 地址、信号强度(RSSI) - 列出所有已配对设备(含 BLE 和经典蓝牙):
blueutil --paired - 筛选当前已连接的 BLE 设备:
blueutil --paired | grep -E "connected: true|BLE"(注意:blueutil 不区分 BLE/Classic 类型字段,需结合设备行为与 RSSI 判断)
连接、断开与取消配对 BLE 设备
操作前请确认目标设备 MAC 地址准确(格式如 aa:bb:cc:dd:ee:ff 或 AA-BB-CC-DD-EE-FF):
- 连接设备:
blueutil --connect "aa:bb:cc:dd:ee:ff"—— 对部分 BLE 外设(如传感器、门锁)有效;对音频类设备可能无响应 - 断开连接:
blueutil --disconnect "aa:bb:cc:dd:ee:ff" - 取消配对(即“忘记此设备”):
blueutil --forget "aa:bb:cc:dd:ee:ff"—— 立即从系统蓝牙列表中移除,下次需重新进入配对模式
补充说明:BLE 配对的特殊性
与经典蓝牙不同,多数 BLE 设备(如心率带、温湿度传感器、iBeacon)采用无配对广播模式,不保存长期密钥,因此不存在传统意义上的“配对记录”。这类设备在 macOS 中通常只显示为可发现设备,不会出现在 --paired 列表中。真正需要配对的 BLE 设备(如某些 HID 键盘、支持 GATT 安全连接的门锁)才会生成持久化条目,此时 --forget 才生效。若目标设备始终无法通过 blueutil 连接,大概率属于纯广播型,应使用专用 App 或 Core Bluetooth 开发工具交互。











