blueutil是macOS高效管理蓝牙的命令行工具,支持安装、电源控制、设备发现、连接/断开、配对/取消配对及JSON格式输出;配合system_profiler和killall blued可深度诊断与重置蓝牙服务。

MacOS的蓝牙模块和配对列表可以通过终端命令高效管理,无需依赖图形界面。这些操作直接作用于系统底层服务与配置文件,适合快速修复连接异常、清理冲突记录或批量控制设备。
查看蓝牙当前状态与设备详情
运行以下命令可获取蓝牙模块的完整运行信息,包括是否启用、芯片型号、固件版本及已连接设备:
system_profiler SPBluetoothDataType
重点关注输出中的 State(应为 On)、Discoverable(是否可被发现)、Firmware Version(固件过旧可能引发兼容问题)。如需快速定位状态,可加过滤:
system_profiler SPBluetoothDataType | grep -A 5 "State"
若命令无响应或报错,说明蓝牙守护进程可能已崩溃,需进入重启流程。
强制重启蓝牙核心服务
macOS 的蓝牙由 blued 进程驱动。终止并让系统自动重启它,能绕过界面卡顿或服务挂起问题:
- 打开终端,输入:sudo killall blued
- 输入管理员密码(输入时无显示,输完直接回车)
- 等待约 5 秒,系统会自动拉起新进程
- 随后前往“系统设置 → 蓝牙”,确认图标恢复活跃状态
该操作等效于重置整个蓝牙协议栈,适用于搜不到设备、频繁断连等场景。
清除所有配对设备并重置模块
当鼠标、耳机等设备反复无法识别,很可能是配对缓存损坏或 MAC 地址混淆。通过调试菜单命令可彻底清空:
- 按住 Shift + Option 键,点击菜单栏蓝牙图标
- 选择“调试 → 移除所有设备”
- 再次打开调试菜单,选择“调试 → 重设蓝牙模块”
- 关闭菜单,等待 10 秒后重新开启蓝牙开关
此操作会删除 /Library/Preferences/com.apple.Bluetooth.plist 和用户级蓝牙配置,重建干净的配对环境。
使用 blueutil 精准管理单个设备
blueutil 是 macOS 上功能最完整的第三方蓝牙命令行工具,支持查询、连接、断开、忽略设备等操作:
- 先安装:brew install blueutil
- 列出所有已知设备(含 MAC 地址):blueutil --inquiry
- 连接指定设备(替换为实际地址):blueutil --connect "88:C3:97:2F:89:AA"
- 忽略某设备(相当于“忘记此设备”):blueutil --forget "88:C3:97:2F:89:AA"
配合 blueutil --power 1(开启)或 --power 0(关闭),可实现脚本化蓝牙控制,比如开机自动连接音箱。











