本文介绍如何通过实现 json.Marshaler 接口，在不修改结构体原始字段值的前提下，优雅地为 JSON 输出中的字符串字段（如 URL）自动添加前缀（如主机地址）。
本文介绍如何通过实现 `json.marshaler` 接口，在不修改结构体原始字段值的前提下，优雅地为 json 输出中的字符串字段（如 url）自动添加前缀（如主机地址）。
在 Go 的 JSON 编码场景中，常遇到这类需求：结构体字段存储的是相对路径（如 /thisurl），但对外暴露的 JSON 必须是完整绝对 URL（如 http://myhost.com/thisurl）。若每次 json.Marshal 前手动拼接（如 post.URL = Host + post.URL），不仅侵入业务逻辑、易遗漏，还会意外污染原始数据——这违背了“序列化行为与数据表示分离”的设计原则。
最佳实践是使用自定义类型 + json.Marshaler 接口。它将序列化逻辑封装在类型内部，使 json.Marshal 自动调用定制方法，完全透明且可复用。
以下是一个完整、生产就绪的示例：
package main
import (
"encoding/json"
"fmt"
)
const Host = "http://myhost.com" // 符合 Go 语言规范：首字母大写 + 驼峰命名（非全大写）
type Post struct {
URL URLString `json:"url"` // 字段类型改为自定义的 URLString
}
type URLString string // 底层仍为 string，便于赋值和比较
// MarshalJSON 实现 json.Marshaler 接口
func (u URLString) MarshalJSON() ([]byte, error) {
// 拼接 Host + 原始值，并手动构造带双引号的 JSON 字符串
// 注意：需转义特殊字符（本例中 u 为纯路径，暂可忽略；生产环境建议用 json.Marshal 处理）
return []byte(fmt.Sprintf(`"%s%s"`, Host, string(u))), nil
}
// （可选）补充 UnmarshalJSON，保证反序列化时仍能正确解析原始路径
func (u *URLString) UnmarshalJSON(data []byte) error {
var s string
if err := json.Unmarshal(data, &s); err != nil {
return err
}
// 反序列化时剥离 Host 前缀，只保留路径部分
if len(s) >= len(Host) && s[:len(Host)] == Host {
*u = URLString(s[len(Host):])
} else {
*u = URLString(s)
}
return nil
}
func main() {
post := Post{URL: "/thisurl"}
data, err := json.Marshal(post)
if err != nil {
panic(err)
}
fmt.Println(string(data)) // 输出：{"url":"http://myhost.com/thisurl"}
// 验证原始值未被修改
fmt.Printf("Raw URL: %q\n", string(post.URL)) // 输出："/thisurl"
}✅ 关键优势：
- 零副作用：post.URL 始终保持原始相对路径，业务逻辑不受影响；
- 强一致性：所有 json.Marshal 调用自动应用前缀，无需人工干预；
- 高内聚：序列化规则与类型绑定，易于测试、复用和维护；
- 符合 Go 习惯：使用驼峰常量名 Host，字段名 URL（而非 Url），遵循 Go Code Review Comments 规范。
⚠️ 注意事项：
- MarshalJSON 中直接拼接字符串虽简洁，但若 u 可能含双引号、换行等 JSON 特殊字符，应改用 json.Marshal 安全编码：
full := Host + string(u) return json.Marshal(full)
- 若需支持反序列化（如接收前端传来的完整 URL），务必实现 UnmarshalJSON，并合理处理前缀剥离逻辑；
- 此方案适用于单字段定制。若多个字段需类似处理，可抽象为泛型工具函数或组合类型，但需权衡复杂度。
总之，通过 json.Marshaler 接口定制序列化行为，是 Go 中解耦数据模型与序列化格式的标准、优雅且可扩展的解决方案。
