54 lines
3.2 KiB
Markdown
54 lines
3.2 KiB
Markdown
# CHANGELOG
|
||
|
||
## [v1.2.1] - 2026-05-04
|
||
### Added
|
||
- **Encoder 元数据缓存**: 引入 `encoderStructDescriptor` 缓存，大幅减少结构体序列化时的反射开销。
|
||
- **time.Time 全局支持**:
|
||
- Encoder/Decoder 原生支持 `time.Time` 类型。
|
||
- 默认使用格式 `2006-01-02 15:04:05.000`。
|
||
- 支持通过 Struct Tag 指定格式（如 `json:"format=2006-01-02"`）。
|
||
- **零分配摩擦匹配**: 重构 Decoder 匹配逻辑，实现 `normalizeEqual` 算法，在忽略大小写/下划线匹配时彻底消除内存分配。
|
||
|
||
### Optimized
|
||
- **Encoder 性能**:
|
||
- 采用 `MapRange` 代替 `MapKeys` 遍历 Map，减少中间切片分配。
|
||
- 延迟 Path 路径计算，仅在开启脱敏字典时计算路径。
|
||
- 重写 `writeString`，支持批量写入与高效查表转义。
|
||
- **Decoder 性能**:
|
||
- 优化 `decodeArray` 扩容策略，优先尊重并使用用户预设的 Capacity。
|
||
- **移除 Map 排序**: 序列化 Map 时不再进行 Key 排序，显著提升大规模 Map 的处理速度。
|
||
|
||
## [v1.2.0] - 2026-05-04
|
||
### Added
|
||
- **零摩擦 API**: 核心 API `To[T]`, `ToJSON`, `FromJSON`, `ToMap`, `ToSlice` 全部重构为**不返回错误**，遇错静默返回零值。
|
||
- **As 包装器**: 原 `Quiet` 更名为 `As`，用于一键消除传统 `(value, error)` 函数的摩擦。
|
||
### Removed
|
||
- **YAML 支持**: 移除 `gopkg.in/yaml.v3` 依赖。
|
||
- **Must/As[T] 系列**: 移除 `Must` 及所有特殊的 `AsXxx` 系列函数，统一通过 `To[T]` 或 `As` 包装实现。
|
||
- **冗余 API**: 移除 `PrettyToJSONBytes` 和 `ToJSONDesensitize`，保留对应的 `PrettyToJSON` 和 `ToJSONDesensitizeBytes`。
|
||
|
||
## [v1.1.2] - 2026-05-04
|
||
### Added
|
||
- 新增 `ToMap` 和 `ToSlice`: 侧重于原地填充/追加，支持 Struct 继承拍平、KV 序列化与自动类型转换。
|
||
- 新增 `MakeMap`, `MakeSlice`, `FromJSON`, `FromYAML` 系列: 泛型构建新对象的零摩擦 API。
|
||
- 增强 `UnmarshalJSON` / `UnmarshalYAML`: 重构为副作用模式（返回 error），支持多种输入类型。
|
||
### Removed
|
||
- 移除 `Ints` 和 `Strings`: 由更通用的 `MakeSlice` 替代，保持 API 简洁。
|
||
|
||
## [v1.1.1] - 2026-04-12
|
||
|
||
- **修复**: 解决 `FastEncoder` 在编码结构体时忽略匿名嵌入（Embedded）字段的问题，确保组合对象的完整序列化。
|
||
|
||
## [v1.1.0] - 2026-05-02
|
||
- **功能**: 新增 `FastEncoder`，实现单路径 JSON 编码，大幅提升性能并减少内存分配。
|
||
- **功能**: 新增 `ToJSONDesensitize` 和 `ToJSONDesensitizeBytes`，支持原生字段脱敏。
|
||
- **功能**: 新增 `FastDecoder`，实现单路径流式 JSON 解析，支持“零摩擦” Key 匹配（大小写不敏感、归一化映射）。
|
||
- **优化**: 完善 `null` 值处理逻辑，区分 `nil` 指针与空 `slice`/`map`。
|
||
- **重构**: 移除旧版 `makeJSONType` 等冗余逻辑，代码结构更简洁高效。
|
||
|
||
## [v1.0.4] - 2026-04-30
|
||
- **优化**: 重构 `UniqueAppend`，改用 Map 查重，性能提升至 $O(n)$。
|
||
- **优化**: 提升 `If` 函数参数描述性，符合工程规范。
|
||
- **优化**: 精简 `parseInt`/`parseUint` 逻辑，减少冗余字符串扫描。
|
||
- **优化**: 优化 `FixUpperCase` 内部字符处理，引入位运算提升效率。
|