encoding/TEST.md

Test Report: @go/encoding

📋 测试概览

• 测试时间: 2026-05-01
• 测试环境: darwin/amd64
• Go 版本: 1.25.0

✅ 功能测试 (Functional Tests)

场景	状态	描述
TestHex	PASS	Hex 编解码往返一致性，Must 系列静默处理测试。
TestBase64	PASS	Standard/URL Base64 编解码一致性，静默 API 测试。
TestWebEncoding	PASS	URL 编解码、HTML 转义反转义往返测试。
TestUtf8	PASS	UTF-8 校验逻辑测试。
TestIntEncoder	PASS	包含正常编解码、FillInt 补齐、ExchangeInt 置换、HashInt 确定性测试。

🛡️ 鲁棒性防御 (Robustness)

• 静默处理 (Quiet Mode)：所有 MustUnXxx API 对非法数据均返回空切片 []byte{} 或空字符串，有效防止业务逻辑中的非预期中断或 Panic。
• 参数校验：NewIntEncoder 对字符集重复、长度不足等构造错误进行了防御性校验，强制要求单字节字符集。
• 性能优化：Hex 解码优化，减少了不必要的字符串到字节切片的转换和内存分配。

⚡ 性能基准 (Benchmarks)

函数	平均耗时	性能分析
HexEncode	44.03 ns/op	高效处理二进制数据，优化后性能稳步提升。
Base64Encode	39.73 ns/op	吞吐量优异。
IntEncoder	44.63 ns/op	整数编码逻辑极简，开销极小。