最常见原因是结构体字段未导出（首字母小写），json包只能解析导出字段；需确保字段首字母大写并正确使用json标签，且不可忽略err判断。

用 json.Unmarshal 解析 JSON 字符串时为什么总得到零值？

最常见原因是结构体字段未导出（即首字母小写），Go 的 json 包只能访问导出字段。即使 JSON 键名完全匹配，私有字段也不会被填充。

• 确保结构体字段首字母大写，例如 UserName 而非 userName
• 用 json:"username" 标签显式映射键名，大小写不敏感但必须存在对应导出字段
• 检查 JSON 字符串是否有效：可先用 json.Valid([]byte(data)) 判断，避免静默失败
• 错误处理不能忽略：err 为 nil 才代表解析成功，否则可能部分字段被设为零值而无提示

type User struct {
    ID       int    `json:"id"`
    UserName string `json:"username"`
    Email    string `json:"email"`
}
var u User
err := json.Unmarshal([]byte(`{"id":1,"username":"alice","email":"a@b.c"}`), &u)
if err != nil {
    log.Fatal(err) // 不要只打印或跳过
}

解析嵌套 JSON 或动态字段该用 map[string]interface{} 还是自定义结构体？

优先选结构体——类型安全、IDE 支持好、性能高；仅当字段不确定、API 版本混杂或需遍历未知键时，才退化用 map[string]interface{}。

• 嵌套对象直接定义嵌套结构体，无需额外处理：Profile struct { AvatarURL string `json:"avatar_url"` }
• 数组字段用切片：如 Roles []string `json:"roles"` 或 Items []Item `json:"items"`
• 用 json.RawMessage 延迟解析某字段（比如日志中混合多种事件类型），避免重复解码
• map[string]interface{} 中的数字默认是 float64，取整数需手动类型断言，易 panic

如何安全地从 HTTP 响应读取并解析 JSON？

别直接对 response.Body 调用 json.NewDecoder 后再调用 Close ——Decode 不会自动关闭 Body，且错误时容易泄露连接。

• 始终用 defer resp.Body.Close()，放在 http.Get 或 client.Do 之后立刻执行
• 用 json.NewDecoder(resp.Body).Decode(&v)，它比 Unmarshal 更省内存，尤其响应较大时
• 检查 resp.StatusCode 是否为 2xx，HTTP 错误状态码下 Body 仍可能有 JSON 错误信息，但你不该把它当正常数据解析
• 超时控制必须设：用 &http.Client{Timeout: 10 * time.Second}，否则默认无超时，请求卡住会阻塞整个 goroutine

json.Marshal 输出中文乱码或转义斜杠怎么办？

默认行为是把非 ASCII 字符转成 \uXXXX，且将 / 转义为 \/（防 XSS）。这不是 bug，是标准安全策略。

• 输出可读中文：用 json.MarshalIndent 或包装一层 json.Encoder 并调用 SetEscapeHTML(false)
• 禁止转义斜杠：必须用 Encoder，设置 enc.SetEscapeHTML(false)，Marshal 函数无法关闭此行为
• 注意：禁用 HTML 转义后，若 JSON 直接插入 HTML ，需自行过滤 等敏感序列
• 时间字段默认序列化为字符串（RFC3339），如需时间戳整数，得自定义 MarshalJSON 方法

var buf bytes.Buffer
enc := json.NewEncoder(&buf)
enc.SetEscapeHTML(false) // 关键：关闭斜杠转义
err := enc.Encode(map[string]interface{}{"path": "/api/v1/users"})
// 输出 {"path":"/api/v1/users"}，而非 {"path":"\/api\/v1\/users"}

实际项目里最容易被忽略的是错误路径下的 Body 处理和结构体字段导出规则——这两处一错，程序就“看起来没报错，但数据永远空”。