语义化版本号是遵循SemVer规范的字符串格式（如v2.1.0），用于明确表达API兼容性变更；不能直接用字符串作二进制版本，因其占用空间大、无法用memcmp安全比较，必须编译期转为紧凑可排序整数（如0x02010000）。
什么是语义化版本号，为什么不能直接用字符串当二进制版本？
语义化版本（SemVer）格式是 vMAJOR.MINOR.PATCH（如 v2.1.0），本质是人类可读的字符串。但二进制中存字符串既浪费空间又难比较——你没法用 memcmp 安全比大小，也不能直接参与链接脚本或固件头校验。真正要的是把 2.1.0 编译期转成一个紧凑、可排序、平台中立的整数，比如 0x02010000（32 位）或 0x00020100（小端布局下 4 字节）。
用 C++20 consteval 在编译期解析字符串字面量
最干净的方式是让编译器在编译时就把 "2.1.0" 拆成数字并打包，避免运行时开销和字符串依赖。C++20 的 consteval 函数能保证这点：
#include <cstdint>
#include <cstddef>
<p>consteval std::uint32_t semver_to_u32(const char* s) {
int major = 0, minor = 0, patch = 0;
size_t i = 0;</p><pre class='brush:php;toolbar:false;'>// 跳过 'v' 或 'V' 前缀（可选）
if (s[0] == 'v' || s[0] == 'V') ++i;
// 解析 major
while (s[i] >= '0' && s[i] <= '9') {
major = major * 10 + (s[i++] - '0');
}
if (s[i] != '.') return 0;
++i;
// 解析 minor
while (s[i] >= '0' && s[i] <= '9') {
minor = minor * 10 + (s[i++] - '0');
}
if (s[i] != '.') return 0;
++i;
// 解析 patch
while (s[i] >= '0' && s[i] <= '9') {
patch = patch * 10 + (s[i++] - '0');
}
// 检查是否到结尾且数值合理（SemVer 要求非负、不超 16 位）
if (s[i] != '\0' || major > 0xFFFF || minor > 0xFF || patch > 0xFF) return 0;
return (static_cast<std::uint32_t>(major) << 16) |
(static_cast<std::uint32_t>(minor) << 8) |
static_cast<std::uint32_t>(patch);}
// 使用示例 static constexpr std::uint32_t BINARY_VERSION = semver_to_u32("2.1.0");
这个值可在 constexpr 上下文里直接用：初始化静态数组、作为模板参数、写入 .rodata 段。注意：consteval 要求输入必须是字面量（如 "2.1.0"），不能是变量或运行时读入的字符串。
立即学习“C++免费学习笔记（深入）”；
兼容 C++17 及更早：用宏 + 预处理器生成整数
如果项目卡在 C++17，consteval 不可用，就得靠预处理器。常见做法是定义三个宏，再组合：
-
VERSION_MAJOR、VERSION_MINOR、VERSION_PATCH分别定义为数字（不是字符串！） - 用宏拼出二进制值：
#define BINARY_VERSION ((VERSION_MAJOR - 确保构建系统（CMake / Makefile）把这三个宏传给编译器，例如：
-DVERSION_MAJOR=2 -DVERSION_MINOR=1 -DVERSION_PATCH=0
这样生成的 BINARY_VERSION 是真正的整型常量，无运行时成本，也兼容所有标准。缺点是版本号分散在构建配置和头文件里，容易不同步；而 consteval 方式把版本字符串和转换逻辑锁死在一处，更易维护。
容易踩的坑：字节序、溢出与链接可见性
生成的整数默认按 host 字节序存放，但如果你把它写进固件头或网络协议字段，可能需要明确小端或大端。别依赖 htonl() ——那是运行时函数。改用 std::byteswap（C++23）或手写位移（如 (v & 0xFF) > 8) & 0xFF) ）做编译期字节翻转。
另一个坑是版本号超限：比如 MAJOR=65536 会溢出 16 位字段，导致高位截断。建议在 consteval 函数里加范围检查，并触发编译错误（用 static_assert 或返回非法值后由调用方 static_assert(BINARY_VERSION != 0) 捕获）。
最后，若该版本号需被其他语言（如 Rust 或 Python）读取，或用于链接脚本（SECTIONS { .version : { *(.version) } }），务必声明为 extern "C" 并设 [[gnu::visibility("default")]]，否则可能被 LTO 优化掉或符号不可见。
