在 BlueZ 5.x 庞大的源码体系中，util模块扮演着"幕后英雄"的角色。它不是直接处理蓝牙协议栈核心逻辑的主角，却是支撑所有模块运转的基础设施。从 HCI 命令封包的字节序处理、设备地址的格式转换，到 GATT 服务 UUID 的可读化显示、调试日志的十六进制输出，几乎每一个模块都在高频复用 util 模块提供的通用工具函数。目录一、util 模块整体架构与定位二、字符串处理工具：高效解析与分隔三、地址解析工具：BD 地址的生命周期管理四、位运算与 ID 管理：位图分配机制五、数据校验与错误映射：HCI 错误码的人性化六、时间处理与定时器封装七、内存管理：安全分配与零初始化八、日志与调试工具九、UUID 与 Appearance 映射：协议数据的人类可读化十、字节序与非对齐访问：协议数据的基石十一、跨模块支撑实战十二、设计思想总结十三、开发调试实战技巧十四、总结本文基于 BlueZ 5.x 完整源码，深入剖析 util 模块的设计哲学、核心实现与跨模块支撑价值。覆盖的源码文件包括：[lib/bluetooth.h]— 底层蓝牙数据类型定义与地址操作[lib/bluetooth.c]— BD 地址转换与错误码映射[src/shared/util.h] — 通用工具宏与函数声明[src/shared/util.c]— 工具函数实现与 UUID/Appearance 映射表[src/shared/timeout.h]— 定时器接口封装[src/shared/timeout-glib.c]— GLib 主循环适配实现一、util 模块整体架构与定位1.1 双层工具架构BlueZ 的 util 模块并非单一文件，而是由两个层次的工具集组成：