GolangJSON返回乱码解决方法

Golang中JSON返回中文显示为\uXXXX Unicode转义序列并非乱码，而是默认安全策略所致；真正解决需双管齐下：一方面用json.Encoder替代json.Marshal并调用SetEscapeHTML(false)实现中文直出与可读性提升，另一方面必须在编码前显式设置响应头Content-Type: application/json; charset=utf-8，否则老客户端可能错误解析为ISO-8859-1导致中文变方块或问号——二者缺一不可，且需根据使用场景权衡XSS风险（纯API可放心关闭转义，HTML内嵌则须谨慎），避开常见“只设头不关转义”或“关了转义却漏设编码”的致命组合坑。

Go json.Marshal 返回中文是 Unicode 转义怎么办

默认情况下，json.Marshal 会把非 ASCII 字符（比如中文）转成 \u4f60\u597d 这种 Unicode 转义序列，浏览器或调试工具里看着像乱码，其实不是编码错误，只是没“人性化”显示。

解决方法很简单：用 json.Encoder 替代 json.Marshal，并调用 SetEscapeHTML(false)：

encoder := json.NewEncoder(w)
encoder.SetEscapeHTML(false)
encoder.Encode(data)

• SetEscapeHTML(false) 不仅让中文直出，还会避免把 <、> 等字符转义，适合 API 场景
• 别在 http.ResponseWriter 上手动调 w.Header().Set("Content-Type", "application/json; charset=utf-8") 后再写字符串——那样容易漏掉 encoder 的自动换行和逗号处理
• 如果必须用 json.Marshal（比如要先日志记录），记得用 bytes.ReplaceAll 手动解转义（不推荐，易出错）

HTTP 响应头没设 UTF-8 导致前端解析失败

即使 JSON 内容本身是 UTF-8 编码，如果响应头缺失 charset=utf-8，某些老客户端（如 IE、部分安卓 WebView）可能按 ISO-8859-1 解析，中文就变问号或方块。

正确做法是在写 JSON 前显式设置响应头：

w.Header().Set("Content-Type", "application/json; charset=utf-8")

• 这行必须在 encoder.Encode() 或 w.Write() 之前调用，否则无效
• 不要写成 "application/json;charset=UTF-8"（等号前后空格、大小写不敏感，但连写易被某些中间件截断）
• 如果你用了 Gin/Echo 等框架，它们通常默认设置了，但自定义中间件或直接用 net/http 时极易遗漏

结构体字段含 HTML 特殊字符，SetEscapeHTML(false) 引发 XSS 风险

关闭 HTML 转义虽能显示中文，但如果结构体字段来自用户输入（比如评论内容），且接口被嵌入 HTML 页面（如通过 document.write 或 innerHTML 渲染），就可能触发 XSS。

这不是 JSON 编码问题，而是使用方式错位：

• 纯 API 接口（返回给 JS fetch 或移动端）可以放心关转义
• 如果后端模板直接把 JSON 插入 HTML 的