如何在 Go 中正确创建 json.RawMessage 字面量

json.RawMessage 底层是 []byte 类型，因此不能直接用字符串字面量赋值，而需显式转换为 []byte 或使用字节切片字面量。本文详解其正确初始化方式、常见误区及序列化注意事项。

`json.rawmessage` 底层是 `[]byte` 类型，因此不能直接用字符串字面量赋值，而需显式转换为 `[]byte` 或使用字节切片字面量。本文详解其正确初始化方式、常见误区及序列化注意事项。

在 go 的 json 处理中，json.RawMessage 是一个非常实用的类型，它允许你延迟解析（或跳过解析）某段 JSON 数据，将其以原始字节形式暂存，待后续按需解码。但初学者常误以为可像普通字符串一样直接赋值，例如：

// ❌ 错误：类型不匹配 — string 无法直接赋给 json.RawMessage（本质是 []byte） Message: "{}", // 编译报错：cannot use string as json.RawMessage

这是因为 json.RawMessage 的定义为 type RawMessage []byte，它是一个底层为字节切片的命名类型，而非字符串别名。因此，正确初始化必须满足 []byte 类型约束。

✅ 正确方式有以下两种：

1. 使用 []byte() 类型转换（推荐，语义清晰）

type ErrorMessage struct {     Timestamp string          `json:"timestamp"`     Message   json.RawMessage `json:"message"` }  func getTestData() ErrorMessage {     return ErrorMessage{         Timestamp: "test-time",         Message:   []byte(`{"code":400,"reason":"invalid input"}`),     } }

2. 直接使用字节切片字面量（等效但可读性略低）

Message: []byte{123, 34, 99, 111, 100, 101, 34, 58, 52, 48, 48, 125}, // {"code":400}

⚠️ 重要注意事项：

• 避免取地址陷阱：json.RawMessage 在结构体中应作为值类型使用；若需指针（如 *json.RawMessage），则无法在结构体字面量中直接取 []byte{…} 的地址（因字面量无固定地址），此时应先声明变量再取址：

  raw := []byte(`{"error":"not found"}`) msg := ErrorMessage{     Timestamp: "now",     Message:   *(&json.RawMessage{raw}), // 不推荐，冗余且易错     // ✅ 更佳写法：     // Message: json.RawMessage(raw), }

• 确保 JSON 合法性：RawMessage 不校验内容有效性。若传入非法 JSON（如 []byte(“{“)），后续调用 json.Marshal() 可能 panic，建议在开发期配合 json.Valid() 验证：

  if !json.Valid([]byte(`{"key": "value"}`)) {     log.Fatal("invalid JSON for RawMessage") }

• 序列化行为：当结构体含 json.RawMessage 字段并被 json.Marshal() 时，其内容会被原样嵌入，不会额外加引号或转义：

  data := getTestData() b, _ := json.Marshal(data) // 输出：{"timestamp":"test-time","message":{"code":400,"reason":"invalid input"}}

总结：json.RawMessage 字面量的本质是 []byte 字面量。牢记“字符串需显式转 []byte”，避开类型混淆；优先使用 []byte(“…”) 而非裸字符串；结合 json.Valid() 提升健壮性——这既是 Go 类型系统严谨性的体现，也是高效处理动态/半结构化 JSON 的关键实践。