Go 十六进制字符串包含空格时怎样处理

如果十六进制文本是从日志、配置文件或人工复制来的，常常会变成 48 65 6c 6c 6f 这样的带空格形式。Go 的 hex.DecodeString 不会把空格当作分隔符，它要求输入只包含十六进制字符，并且字符数为偶数。处理方式是：在输入边界按约定清理空白，随后检查空输入和长度，最后再调用解码器处理非法字符。

官方文档：https://pkg.go.dev/encoding/hex#DecodeString

空格为什么会让 DecodeString 失败

encoding/hex 负责的是十六进制编码，不负责猜测文本里的分隔格式。比如下面的字符串在人眼看来只是把字节分组了，但空格本身不是十六进制字符：

package main

import (
	"encoding/hex"
	"fmt"
)

func main() {
	// 空格是展示分隔符，不属于十六进制数据本身。
	input := "48 65 6c 6c 6f"
	decoded, err := hex.DecodeString(input)
	fmt.Printf("decoded=%q err=%v\n", decoded, err)
}

因此，问题不在于 DecodeString 不能处理字节，而在于输入还停留在“带格式的文本”阶段。先决定空格是否只是展示分隔符，再决定清理方式，排查会更稳定。

先在输入边界统一清理空白

如果业务约定允许空格、换行和制表符作为分隔符，可以用 strings.Fields 拆出非空片段，再用 strings.Join 拼回连续字符串。这个写法比只替换普通空格更稳，因为复制文本时可能混入换行或制表符。

package main

import (
	"encoding/hex"
	"fmt"
	"strings"
)

func decodeHexText(input string) ([]byte, error) {
	// Fields 会按连续空白切分，Join 把展示分隔符移出数据。
	compact := strings.Join(strings.Fields(input), "")
	if compact == "" {
		return nil, fmt.Errorf("十六进制输入为空")
	}
	// 一个字节需要两个十六进制字符，长度为奇数时先返回业务错误。
	if len(compact)%2 != 0 {
		return nil, fmt.Errorf("十六进制字符数为奇数：%d", len(compact))
	}
	return hex.DecodeString(compact)
}

func main() {
	// 允许空格和换行，但不改变有效的十六进制字符。
	decoded, err := decodeHexText("48 65\n6c 6c 6f")
	fmt.Printf("decoded=%q err=%v\n", decoded, err)
}

这里的清理应放在输入边界，而不是散落在多个业务调用点。这样所有进入解码器的字符串都遵守同一条约定，后续日志也能同时记录原始输入来源和规范化后的长度。

把空输入和奇数长度提前分开

空输入、奇数长度和非法字符不是一回事。空输入通常是业务字段缺失；奇数长度意味着半个字节没有配对；非法字符则说明文本中混入了 g、前缀或其它非十六进制内容。先分层，错误信息就不会只剩一句“解码失败”。

func normalizeHex(input string) (string, error) {
	// 只把约定的展示空白移除，保留其它字符交给 DecodeString 判断。
	compact := strings.Join(strings.Fields(input), "")
	if compact == "" {
		return "", fmt.Errorf("十六进制输入为空")
	}
	if len(compact)%2 != 0 {
		return "", fmt.Errorf("十六进制输入长度必须为偶数，当前为 %d", len(compact))
	}
	return compact, nil
}

func decodeWithBoundaryCheck(input string) ([]byte, error) {
	compact, err := normalizeHex(input)
	if err != nil {
		return nil, err
	}
	// 标准库继续负责识别非十六进制字符，不在这里复制字符表。
	return hex.DecodeString(compact)
}

注意：如果项目把空字符串定义为合法的空字节序列，可以删掉空输入分支，让 hex.DecodeString("") 按标准库语义处理；这应当是明确的协议约定，而不是无意产生的结果。

非法字符怎样定位

清理空白后，如果仍有错误，优先保留标准库返回的错误。encoding/hex 为非法字节提供了 hex.InvalidByteError 类型，可以通过 errors.As 识别它，再补充当前输入的上下文。

func decodeAndExplain(input string) ([]byte, error) {
	compact, err := normalizeHex(input)
	if err != nil {
		return nil, err
	}
	decoded, err := hex.DecodeString(compact)
	if err == nil {
		return decoded, nil
	}

	var invalid hex.InvalidByteError
	if errors.As(err, &invalid) {
		// 保留底层错误，同时指出是哪个字节不符合十六进制格式。
		return nil, fmt.Errorf("十六进制包含非法字符 %q：%w", byte(invalid), err)
	}
	return nil, fmt.Errorf("十六进制解码失败：%w", err)
}

如果错误发生在中间位置，标准库可能已经返回部分解码结果。除非业务明确支持“尽可能读取前缀”，否则应把这次调用视为失败，不要把部分结果当成完整数据继续保存。

不要无条件删除所有空白

对于来自用户输入的调试文本，忽略分隔空白通常很方便；但对于协议字段或签名材料，空格可能本来就是非法输入的一部分。此时可以改成“发现空白就拒绝”，而不是自动修复：

func decodeStrictHex(input string) ([]byte, error) {
	// 严格模式不吞掉空白，协议字段必须由调用方先规范化。
	if strings.IndexFunc(input, unicode.IsSpace) >= 0 {
		return nil, fmt.Errorf("严格十六进制输入不能包含空白")
	}
	if len(input)%2 != 0 {
		return nil, fmt.Errorf("严格十六进制输入长度必须为偶数")
	}
	return hex.DecodeString(input)
}

选择“宽松清理”还是“严格拒绝”，取决于输入来源。日志复制、命令行参数和人工粘贴通常适合宽松模式；协议、哈希、签名和需要字节级一致性的字段更适合严格模式。

最后用这张清单排查

• 空格是否只是展示分隔符，业务是否真的允许删除？
• 是否同时处理了换行、制表符等连续空白？
• 清理后是否为空，或者是否出现奇数长度？
• 是否把 0x 前缀、逗号和其它字符误当成合法十六进制？
• 错误时是否保留了 hex.DecodeString 的底层错误，而不是继续使用部分结果？

所以，Go 十六进制字符串包含空格时，核心不是给 hex.DecodeString 寻找特殊参数，而是先在输入边界明确格式：允许分隔空白就规范化，不允许就立即拒绝；之后再让标准库负责偶数长度和字符合法性。

相关问题

带换行的十六进制字符串也能用同样的写法吗？

可以，只要换行确实是展示格式的一部分。strings.Fields 会把连续空白统一当作分隔符；如果换行代表数据边界，则应逐行处理而不是全部拼接。

为什么不直接用 strings.ReplaceAll 删除空格？

只处理普通空格会漏掉制表符和换行。若输入格式明确只有 ASCII 空格，ReplaceAll 可以使用；来源不稳定时，Fields 更能表达“按空白分隔”的意图。

清理后仍然报错怎么办？

检查是否存在奇数长度、0x 前缀、逗号或超出 0-9a-fA-F 的字符，并通过 errors.As 识别 hex.InvalidByteError。