最常见原因是结构体字段未导出（首字母小写），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 处理和结构体字段导出规则——这两处一错，程序就“看起来没报错，但数据永远空”。
