Documentation
¶
Overview ¶
Package encoding 提供常用的编码和哈希工具函数。
当前能力：JSON 编解码包装（MarshalJSON/UnmarshalJSON 等，UseNumber 语义 有显式入口 UnmarshalUseNumber/UnmarshalFromStringUseNumber——数字保留为 json.Number，防 >2^53 float 精度丢失）、非加密哈希 （Fnv1a64）、加密级摘要（Sha256/Sha256Hex）、Base64（标准/URL 安全）。
历史说明：曾提供 Md5/Md5Hex/Md5Bytes/Sha1 弱哈希包装，2026-09-15 治理轮 移除（共享 SDK 提供弱哈希入口容易被误用到凭据/签名场景）；确有 MD5/SHA-1 合规需求的业务自行使用 crypto 标准库。
Index ¶
- func Base64Decode(s string) (string, error)
- func Base64Encode(s string) string
- func Base64URLDecode(s string) (string, error)
- func Base64URLEncode(s string) string
- func Fnv1a64(data []byte) uint64
- func Marshal(v any) ([]byte, error)
- func MarshalIndent(v any, prefix, indent string) ([]byte, error)
- func MarshalToString(v any) (string, error)
- func Sha256(str string) string
- func Sha256Hex(data []byte) string
- func Unmarshal(data []byte, v any) error
- func UnmarshalFromReader(reader io.Reader, v any) error
- func UnmarshalFromString(str string, v any) error
- func UnmarshalFromStringUseNumber(s string, v any) error
- func UnmarshalUseNumber(b []byte, v any) error
- func Valid(data []byte) bool
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Base64URLDecode ¶
Base64URLDecode 解码 Base64 URL 安全编码的字符串。
func Base64URLEncode ¶
Base64URLEncode 返回字符串的 Base64 URL 安全编码。
func Fnv1a64 ¶
Fnv1a64 返回数据的 64 位 FNV-1a 哈希值（非加密哈希，用于缓存分片/内容粗校验）。 跨服务持久化过哈希值的场景请勿更改算法假设（历史名 Hash，2026-09 改为如实命名）。
func MarshalIndent ¶
MarshalIndent 将 v 序列化为带缩进的 JSON 字节。
func MarshalToString ¶
MarshalToString 将 v 序列化为 JSON 字符串。
func Sha256Hex ¶
Sha256Hex 返回数据的 SHA-256 十六进制字符串。 适用于内容校验和、缓存键等非加密签名场景（2026-09-15 治理轮： 移除 Md5/Md5Hex/Md5Bytes/Sha1 包装——共享 SDK 提供弱哈希入口容易被 误用到凭据/签名场景；确有 MD5/SHA-1 合规需求的业务自行引 crypto 标准库）。
func Unmarshal ¶
Unmarshal 将 JSON 字节反序列化到 v。 使用 UseNumber 模式解析数字，避免精度丢失。 与 encoding/json.Unmarshal 语义一致：整个输入必须是单一 JSON 值， 尾部残留数据（截断修复失败/拼接脏数据）视为错误而非静默忽略。
func UnmarshalFromReader ¶
UnmarshalFromReader 从 Reader 读取 JSON 并反序列化到 v。
func UnmarshalFromString ¶
UnmarshalFromString 将 JSON 字符串反序列化到 v。 语义同 Unmarshal：尾部残留数据视为错误。
func UnmarshalFromStringUseNumber ¶ added in v0.3.0
UnmarshalFromStringUseNumber 将 JSON 字符串反序列化到 v。 语义同 UnmarshalUseNumber：数字保留为 json.Number，防 >2^53 精度丢失。
func UnmarshalUseNumber ¶ added in v0.3.0
UnmarshalUseNumber 将 JSON 字节反序列化到 v，数字显式解析为 json.Number （而非 float64）。js 数值只有 53 位整数精度，金额/雪花 ID 等 >2^53 的整数 经 float64 中转会静默丢失精度；json.Number 保留原文字面量，由业务按需 转 int64/string。目标字段为 any 时生效最明显；已声明类型的字段仍按 该类型解析。尾部残留数据视为错误（同 Unmarshal）。
Types ¶
This section is empty.
Source Files