最可靠方式是Windows用WMI查Win32_DiskDrive.SerialNumber（需trim、转UTF-8、COM初始化及代理设置），Linux读/sys/block/*/device/serial（注意路径与fallback），macOS用IOKit（需权限与沙盒配置）；三者均须处理空/无效序列号并fallback。
Windows下用WMI查询硬盘序列号最可靠
纯C++标准库无法获取物理硬盘序列号，必须依赖系统API。Windows平台最稳妥的方式是调用WMI（Windows Management Instrumentation），它能绕过驱动签名限制，且对SATA/NVMe/USB外置盘都有效。直接读取\.PhysicalDrive0需要管理员权限+驱动级访问，还常被安全软件拦截，不推荐。
关键点：WMI查询Win32_DiskDrive类的SerialNumber属性，注意该字段可能含空格或不可见字符，需trim处理；同一台机器多个硬盘时，要靠Index或DeviceID区分。
- 必须链接
ole32.lib和oleaut32.lib - 初始化COM：调用
CoInitializeEx(nullptr, COINIT_MULTITHREADED) - 查询前设置安全上下文：
CoSetProxyBlanket不能省略，否则本地WMI调用会失败 - 返回的
SerialNumber是BSTR，要用WideCharToMultiByte转UTF-8，别直接用_bstr_t隐式转换（可能丢字符）
Linux下通过/sys/block读取序列号有路径陷阱
Linux没有统一接口，但/sys/block/*/device/下通常存在serial文件。问题在于：不是所有设备节点都暴露该文件（尤其NVMe盘默认不显示），且路径依赖设备命名规则（sda vs nvme0n1）。
实操建议优先尝试/sys/block/<var>devname</var>/device/serial，若失败再 fallback 到/sys/block/<var>devname</var>/device/model + /sys/block/<var>devname</var>/device/vendor拼凑标识符——但这不是真实序列号，仅作设备区分。
立即学习“C++免费学习笔记（深入）”；
- 读
/sys/block/sda/device/serial前先检查该文件是否存在且可读（access()） - NVMe盘要查
/sys/block/nvme0n1/device/serial，但部分内核版本需启用nvme_core.default_ps_max_latency_us=0才能暴露 - U盘或虚拟机磁盘大概率返回空或"0000000000000000"，这是硬件本身未提供序列号，非代码问题
macOS需用IOKit但权限和沙盒限制严
macOS要求程序有com.apple.developer.kernel.iokit权限，且从macOS 10.15起，即使有权限，沙盒应用也无法访问IOServiceGetMatchingServices。实际可行方案只有两种：非沙盒命令行工具，或用户手动授予“完全磁盘访问”权限后调用I/O Kit。
核心流程：用IOServiceMatching("IOBlockStorageDevice")匹配设备，再调用IORegistryEntryCreateCFProperty读取Serial Number键。注意返回值是CFTypeRef，需转CFString再转C字符串，中间任何一步失败都返回nullptr。
- 必须在Info.plist中声明
com.apple.security.device.diskentitlement（仅对非App Store分发有效） - 调用
IOServiceGetMatchingServices前需调用IOObjectRetain防止句柄释放 - 常见错误：
kIOReturnNotPrivileged表示权限不足，kIOReturnNotFound表示没找到匹配设备（比如USB盘未被识别为块存储）
跨平台代码必须处理“无序列号”这个事实
无论哪个平台，都可能拿到空字符串、全零字符串或"None"。这不是bug，而是硬件厂商未烧录序列号或固件屏蔽了该信息。强行抛异常或终止程序反而破坏健壮性。
正确做法是把序列号当作弱标识：优先用它，但 fallback 到其他稳定字段组合，比如Windows用Win32_DiskDrive.PNPDeviceID，Linux用/sys/block/*/device/wwn（如果存在），macOS用IORegistryEntryGetPath返回的路径哈希。
- 永远对返回的序列号做
trim()和长度校验（少于4字符基本无效） - 不要缓存结果——热插拔硬盘后序列号可能变化，每次调用都应重新查询
- 日志里记录原始返回值（含不可见字符），方便排查是硬件问题还是解析逻辑问题
序列号获取本身很简单，难的是应对各种“不存在”的情况。硬件层的不确定性，比代码逻辑更值得花时间设计兜底方案。
