PyBlueZ 是 Python 蓝牙扩展模块，支持设备扫描、连接、服务发现及低功耗蓝牙（BLE）等功能。介绍环境安装、基础代码示例、多平台适配机制、常见难题解决及性能优化策略，涵盖智能家居、物联网数据采集等应用场景，帮助开发者快速构建蓝牙应用。
PyBlueZ 是功能强大的 Python 蓝牙扩展模块，让开发者能够快速构建各种蓝牙应用，从简单的设备扫描到复杂的数据传输，都能得心应手。
首先通过简单的命令安装 PyBlueZ：
pip install pybluez
对于 Linux 用户，可能需要安装额外的依赖：
sudo apt-get install libbluetooth-dev
开始蓝牙编程最简单的方式就是设备发现。PyBlueZ 的 discover_devices() 函数让你能够快速扫描周围的蓝牙设备：
import bluetooth
# 快速扫描附近设备
devices = bluetooth.discover_devices(lookup_names=True, duration=5)
print(f"发现 {len(devices)} 个蓝牙设备")
for address, name in devices:
print(f"设备地址：{address}, 设备名称：{name}")
PyBlueZ 采用智能的平台检测机制，在 bluetooth/__init__.py 中根据操作系统自动选择正确的实现：
bluetooth/bluez.py 模块bluetooth/msbt.py 功能bluetooth/macos.py 组件这种设计确保了代码在不同系统上的无缝运行，开发者无需关心底层差异。
蓝牙连接不稳定的问题困扰着许多开发者。通过以下技巧可以显著改善连接质量：
BluetoothError 异常并进行适当处理PyBlueZ 支持完整的服务发现协议 (SDP)，通过 advertise_service() 函数可以轻松注册蓝牙服务：
# 注册自定义蓝牙服务
bluetooth.advertise_service(
server_socket,
"MyService",
service_classes=[bluetooth.SERIAL_PORT_CLASS],
profiles=[bluetooth.SERIAL_PORT_PROFILE]
)
使用 PyBlueZ 连接智能灯泡、温控器等设备，实现远程控制功能。通过简单的 RFCOMM 通信，就能发送控制指令。
在工业物联网场景中，PyBlueZ 可用于连接各种传感器设备，采集温度、湿度等数据并传输到中央服务器。
实现手机与电脑之间的文件传输、消息同步等功能，构建个性化的设备互联方案。
随着 BLE 技术的普及，PyBlueZ 通过 bluetooth/ble.py 模块提供了对低功耗蓝牙设备的完整支持：
from bluetooth.ble import DiscoveryService
# 扫描 BLE 设备
service = DiscoveryService()
ble_devices = service.discover(3)
PyBlueZ 不仅支持基础的 RFCOMM 协议，还提供了 L2CAP、SDP 等多种协议的实现，满足不同场景的需求。
及时关闭不再使用的蓝牙 socket，释放系统资源，避免内存泄漏问题。
在 Linux 系统中，蓝牙操作通常需要 root 权限。可以通过将用户添加到 bluetooth 组来解决：
sudo usermod -a -G bluetooth $USER
确保目标蓝牙设备处于可被发现模式，并检查设备是否被其他程序占用。
PyBlueZ 为 Python 开发者提供了强大而灵活的蓝牙编程能力。无论你是初学者还是有经验的开发者，都能通过本文介绍的技巧快速上手并构建实用的蓝牙应用。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online