std::stoi 和 std::stringstream 无法直接解码 hex 字符串，因其默认十进制解析、不支持批量成对解码、缺乏输入合法性校验；需手写查表法逐对解析偶数长度 hex 字符串，映射为 4-bit 值实现零分配高效解码。
为什么不能直接用 std::stoi 或 std::stringstream 解码 hex 字符串
因为它们默认按十进制解析，遇到 "ff" 会报错或截断；即使指定基数，std::stoi("ff", nullptr, 16) 只能处理单个整数，无法批量还原连续 hex 字符对（如 "68656c6c6f" → "hello"）。更严重的是，它们不校验输入合法性，遇到非法字符（如 'g'）可能抛异常或静默失败。
实际场景中，hex 字符串常来自网络协议、加密输出或二进制 dump，长度固定为偶数，且只含 0-9 和 a-f/A-F。必须逐对解析、校验、合并字节。
- 输入长度必须为偶数，否则无法成对解码
- 每个字符需映射到 4-bit 值：可手写查表（快），也可用
std::tolower+ switch（可读性好） - 避免反复构造
std::string子串，直接用指针或迭代器访问原始字符
手写查表法实现零分配解码（推荐用于性能敏感场景）
预定义 256 字节的查找表，将 ASCII 字符直接映射为对应 4-bit 值或非法标记（如 -1）。这样每次查表只需一次内存访问，无分支预测失败风险，比条件判断快 2–3 倍。
示例关键逻辑：
static constexpr std::array<int8_t> hex_lut = [] {
std::array<int8_t> lut{};
for (auto& v : lut) v = -1;
for (char c = '0'; c std::string hex_decode(std::string_view hex) {
if (hex.size() % 2 != 0) throw std::invalid_argument("hex string length must be even");
std::string out(hex.size() / 2, '\0');
for (size_t i = 0; i (hex[i])];
const uint8_t lo = hex_lut[static_cast<uint8_t>(hex[i+1])];
if (hi == -1 || lo == -1) throw std::invalid_argument("invalid hex character");
out[i/2] = (hi </uint8_t></int8_t></int8_t>
-
hex_lut在编译期初始化，零运行时开销 -
std::string_view避免传参拷贝 - 提前分配
out容量，避免多次 realloc - 错误位置在首次非法字符处立即抛出，不继续执行
使用 std::from_chars 的现代 C++ 方案（C++17+）
如果你的 hex 字符串是分段的（比如每两个字符一个独立字符串），或者想复用标准库的健壮性，std::from_chars 是安全选择。但它不支持直接解析两位十六进制，需先拼成字符串再转——这会引入临时 std::string 分配，性能不如查表法。
适用场景：调试工具、配置解析等对吞吐不敏感但需强类型保障的地方。
- 必须确保输入是合法 hex 字符，
std::from_chars不做范围检查 - 需手动组合高低位：
int hi, lo; std::from_chars(p, p+1, hi, 16); std::from_chars(p+1, p+2, lo, 16); - 返回值
std::errc::invalid_argument表示解析失败，比异常轻量
常见坑：大小写混用、空格与前缀处理
真实数据常带 "0x" 前缀或空格（如 "0x68 65 6c 6c 6f"），但查表法和 std::from_chars 都不自动跳过。必须预处理：
- 用
std::erase（C++20）或循环std::remove_if清除空格、制表符、换行符 - 检查前缀：
if (hex.starts_with("0x") || hex.starts_with("0X")) hex.remove_prefix(2); - 大小写统一不是必须的——查表已覆盖
a-f和A-F，但若用std::tolower辅助，则需确保输入非 null - 空输入或全空白字符串要单独判空，否则查表会访问越界
最易被忽略的是边界校验：哪怕只差一个字符，整个解码就失效，而错误信息往往只说“invalid hex”，没提示具体位置。生产环境建议在抛异常前记录偏移量。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
