如何精确匹配指定长度的十六进制字符串并严格校验字符数

聖光之護 2026-01-07 00:00:00 次阅读

go 中 `fmt.sscanf` 无法强制要求**恰好**读取指定数量的字符；若需实现“必须严格匹配 2 位十六进制字符，多一位或少一位都失败”，应改用 `strconv.parseuint` 配合显式长度检查。

在 Go 的格式化输入解析中，fmt.Sscanf 的行为是贪婪但宽松的：它按格式动词（如 %02x）尝试解析，但并不校验输入是否被完全消费，也不强制要求输入长度与格式中的宽度声明严格一致。例如 %02x 仅表示“至少解析 2 位十六进制数字（不足则补零）”，而非“必须且仅能消耗恰好 2 个字符”。因此，fmt.Sscanf("f!", "%02x", &v) 成功解析 'f'（即 0xf），忽略后续 '!'，返回 n=1（成功扫描 1 个参数），这显然不符合“精确 2 字符”的业务约束。

要实现严格的长度+格式双重校验，推荐使用 strconv.ParseUint —— 它专为字符串到整数的安全转换而设计，并天然配合显式长度检查。以下是推荐实现：

package main

import (
    "fmt"
    "strconv"
)

// parseHexByte 解析恰好 size 位十六进制字符为 uint8
// 若输入长度 ≠ size，或内容非有效十六进制，或值超出 uint8 范围，则返回错误
func parseHexByte(s string, size int) (uint8, error) {
    if len(s) != size {
        return 0, strconv.ErrSyntax // 显式拒绝长度不符
    }
    n, err := strconv.ParseUint(s, 16, 8)
    return uint8(n), err
}

func main() {
    testCases := []string{"ff", "f", "", "f!", "12", "00", "fff"}
    for _, s := range testCases {
        if v, err := parseHexByte(s, 2); err == nil {
            fmt.Printf("✅ '%s' → %d (0x%02x)\n", s, v, v)
        } else {
            fmt.Printf("❌ '%s' → %v\n", s, err)
        }
    }
}

输出示例：

✅ 'ff' → 255 (0xff)  
❌ 'f' → strconv.ParseUint: parsing "f": invalid syntax  
❌ '' → strconv.ParseUint: parsing "": invalid syntax  
❌ 'f!' → strconv.ParseUint: parsing "f!": invalid syntax  
✅ '12' → 18 (0x12)  
✅ '00' → 0 (0x00)  
❌ 'fff' → strconv.ParseUint: parsing "fff": value out of range

✅ 关键优势：