go的encoding/json通过json标签声明式指定字段名，优先级最高；需注意引号、空格、导出性（首字母大写）、嵌套结构需单独标注，不支持运行时动态改键名。
用 json 标签直接控制字段名
Go 的 encoding/json 包默认使用结构体字段名作为 JSON 键，但只要在字段后加 json 标签，就能完全自定义输出名。这不是“替换”，而是声明式指定——标签优先级最高，没标签才 fallback 到字段名。
常见错误是写成 json:"name" 却忘了引号，或误用空格（如 json:" name " 会真的输出带空格的键）。
-
json:"user_name"→ 输出"user_name" -
json:"id,string"→ 输出字符串化的数字（比如"123"） -
json:"-"→ 字段被忽略（注意引号内是短横线，不是空格） -
json:"created_at,omitempty"→ 字段为空值（nil、零值、空 slice/map）时不出现在 JSON 中
嵌套结构体字段名也要单独打标签
很多人以为外层结构体打了 json 标签，内层字段就自动继承，其实不会。每个字段都得独立标注，否则内层仍用原始字段名。
例如：
type User struct {
ID int `json:"id"`
Detail UserInfo `json:"detail"`
}
type UserInfo struct {
Name string `json:"full_name"` // 必须显式写，否则还是输出 "Name"
Age int `json:"age"`
}
如果 UserInfo.Name 没加 json:"full_name"，最终 JSON 里仍是 "Name": "Alice"，不是你想要的 "full_name"。
使用固定的 Next.js/Tailwind/Prisma 技术栈构建并记录独立 SaaS 项目，仅将 FastAPI 用于 Python 工作负载，并遵循严格的架构规范。
运行时动态改 JSON 键名？别硬来
Go 的 json 标签是编译期静态的，不支持运行时根据条件切换键名。试图用反射+重写 MarshalJSON 方法来动态生成键，容易踩坑：
- 递归处理嵌套结构时易漏字段或无限循环
- 失去
omitempty等内置行为，得手动模拟 - 性能下降明显，尤其对高频 API 响应
真有差异化输出需求（比如同一结构体在不同接口要不同字段名），更稳妥的做法是定义多个专用结构体，各自打好标签。虽然代码略多，但清晰、可测、无副作用。
注意大小写和导出性限制
Go 要求 JSON 字段只能映射到**导出字段**（首字母大写）。如果字段是小写（如 name string），哪怕写了 json:"name"，序列化结果里也不会出现它——因为 encoding/json 根本看不到这个字段。
另外，json 标签里的名字区分大小写，但 Go 字段名本身必须导出。所以 userName string `json:"user_name"` 是合法的，而 username string `json:"user_name"` 不会出现在输出中。
最容易被忽略的是：标签生效的前提是字段可导出 + 标签语法正确 + 没拼错字段名。三者缺一不可。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
