本文介绍一种自定义 json.unmarshaler 实现——jsonstring 类型，可将 json 中的数字、字符串、布尔值、null 等任意合法原始值无损转为原始 json 字符串表示（如 123 → "123"，true → "true"），避免类型预判与中间解析开销。
本文介绍一种自定义 json.unmarshaler 实现——jsonstring 类型，可将 json 中的数字、字符串、布尔值、null 等任意合法原始值无损转为原始 json 字符串表示（如 123 → "123"，true → "true"），避免类型预判与中间解析开销。
在 Go 的标准库中，encoding/json 提供了 json.Number 类型用于延迟解析数字，但并未内置类似 json.String 的通用原始值捕获机制。当面对结构不确定的 JSON 字段（例如配置项、用户输入、第三方 API 返回的动态字段）时，开发者常需将任意 JSON 值（string/number/boolean/null）统一转为字符串进行后续处理（如日志记录、模板渲染、类型弱校验等）。直接使用 interface{} 再手动类型断言不仅冗长，还易遗漏 nil 或嵌套情况；而 json.RawMessage 虽保留原始字节，却无法自动适配不同 JSON 类型的序列化格式（如 true 的原始字节是 true，而非 "true"）。
为此，我们可通过实现 UnmarshalJSON 方法定义一个轻量级自定义类型 JsonString：
type JsonString string
// jsonString 是 JsonString 的别名，用于避免递归调用 UnmarshalJSON
type jsonString JsonString
func (s *JsonString) UnmarshalJSON(data []byte) error {
// 尝试按字符串解码
var str jsonString
if err := json.Unmarshal(data, &str); err == nil {
*s = JsonString(str)
return nil
}
// 否则尝试数字（uint64 覆盖正整数和 0；float64 覆盖小数和负数）
var num uint64
if err := json.Unmarshal(data, &num); err == nil {
*s = JsonString(data)
return nil
}
var f float64
if err := json.Unmarshal(data, &f); err == nil {
*s = JsonString(data)
return nil
}
// 尝试布尔值
var b bool
if err := json.Unmarshal(data, &b); err == nil {
*s = JsonString(data)
return nil
}
// 尝试 null（json.Unmarshal 会将 null 解到任意类型为零值，但需确保不误判空字符串）
if len(data) == 4 && string(data) == "null" {
*s = ""
return nil
}
// 所有尝试失败，返回原始错误
return fmt.Errorf("cannot unmarshal %s into JsonString", string(data))
}该实现的核心逻辑是：不对 JSON 原始字节做解析，而是利用标准 json.Unmarshal 的类型匹配能力逐次试探，并在成功时直接保存原始字节切片（string(data)）。这样既保证了语义正确性（123 解为 "123"，而非 "123.0" 或 "123" 的字符串值），又避免了精度损失（如大整数或科学计数法浮点数）。
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
使用示例如下：
type Payload struct {
Number JsonString `json:"number"`
String JsonString `json:"string"`
Float JsonString `json:"float"`
Bool JsonString `json:"bool"`
Empty JsonString `json:"empty"`
Null JsonString `json:"null"`
}
data := []byte(`{
"number": 123,
"string": "123",
"float": 123.45,
"bool": true,
"empty": "",
"null": null
}`)
var p Payload
if err := json.Unmarshal(data, &p); err != nil {
log.Fatal(err)
}
fmt.Printf("Number: %q\n", string(p.Number)) // "123"
fmt.Printf("String: %q\n", string(p.String)) // "123"
fmt.Printf("Float: %q\n", string(p.Float)) // "123.45"
fmt.Printf("Bool: %q\n", string(p.Bool)) // "true"
fmt.Printf("Empty: %q\n", string(p.Empty)) // ""
fmt.Printf("Null: %q\n", string(p.Null)) // ""⚠️ 注意事项：
- JsonString 仅支持 JSON 原始值（primitive），不支持对象 {} 或数组 [] —— 若输入为复合类型，所有 json.Unmarshal 尝试均失败，将返回错误；
- 原始字节被直接转换为 string，因此结果严格等于 JSON 文本中的字面量（含引号、大小写、空格等），如 true → "true"，"abc" → "abc"（注意：双引号保留在字符串内，即实际值为 "\"abc\""）；
- 若需去除字符串外层引号（如将 "hello" 转为 hello），应在业务层额外调用 strings.Trim 或 strconv.Unquote；
- 为提升健壮性，建议在生产环境添加对空白字符（如换行、缩进）的容忍处理，或使用 json.Compact 预处理。
综上，JsonString 是一种简洁、高效、符合 Go 惯例的解决方案，适用于需要“原始 JSON 字面量字符串化”的场景，兼顾安全性与可维护性。
