go结构体字段必须首字母大写才能被json序列化导出，而json:"user_name"标签控制输出键名；小写字段直接被忽略，故需大写字段名+显式标签实现snake_case映射。
为什么 JSON 字段名首字母小写但结构体字段却大写？
因为 Go 的 JSON 序列化默认依赖结构体字段的导出性（首字母大写）和 json 标签。Gin 的 c.ShouldBindJSON() 和 c.JSON() 都走标准 encoding/json 包，它不会自动把大写字段转成小写 key——而是靠你显式声明 json:"xxx" 标签来控制输出名。
常见错误现象：
前端传 {"user_name":"alice"}，后端结构体写 UserName string 却收不到值；或者返回时字段是 "UserName" 而不是预期的 "user_name"。
- 结构体字段必须首字母大写才能被
encoding/json导出，否则序列化/反序列化时直接忽略 - 不加
json标签时，默认使用字段名（首字母大写变小写），例如UserName→"userName"，不是"user_name" - 要生成下划线风格（snake_case），必须手动加
json:"user_name"标签
如何让 Gin 统一处理 snake_case 字段名？
不能靠 Gin 自身配置切换，得改结构体定义或封装序列化逻辑。最直接、最可控的方式是在每个字段上加 json 标签。
示例：
type UserRequest struct {
UserName string `json:"user_name"`
Age int `json:"age"`
IsActive bool `json:"is_active"`
}
这样 c.ShouldBindJSON(&req) 就能正确解析 {"user_name":"bob","age":25}；c.JSON(200, resp) 也会输出下划线字段名。
- 标签值为空字符串（
json:""）表示忽略该字段；json:"-"表示完全排除 - 如果字段有多个用途（比如同时用于 JSON 和数据库），可叠加标签：
json:"user_name" gorm:"column:user_name" - 别用
json:",string"这类额外选项，除非真需要把数字转成字符串传
有没有办法全局启用 snake_case 而不用每个字段都写标签？
标准库不支持，Gin 也不提供钩子。有人尝试用反射+自定义 MarshalJSON，但代价高、易出错、破坏可读性，不推荐。
真正可行的折中方案只有两个：
- 用代码生成工具（如
stringer或自定义go:generate脚本）从结构体定义自动生成带json标签的副本类型 - 在团队规范里强制要求：所有 HTTP 层结构体必须显式声明
json标签，CI 加检查（比如用staticcheck或自定义 AST 扫描器报未标注字段）
试图用中间件拦截并重写 JSON 字节流，会破坏 Gin 的绑定流程，且无法处理嵌套结构体或指针字段，容易引发 panic。
Gin 中 c.ShouldBindJSON 和 c.BindJSON 有什么区别？
关键差异在错误处理方式：c.ShouldBindJSON 不会终止请求，允许你手动判断错误；c.BindJSON 遇错自动返回 400 并中断后续逻辑。
如果你要统一做字段名兼容（比如同时接受 user_name 和 userName），必须用 ShouldBindJSON + 自定义解码逻辑（例如先用 json.RawMessage 拿原始字节，再双路径解析），但这样会让业务代码变重，一般只在灰度迁移期临时用。
- 日常开发请坚持单一命名约定，不要在 API 层混用 camelCase 和 snake_case
-
BindJSON更适合强校验场景；ShouldBindJSON更适合需要 fallback 或日志记录的场景 - 无论选哪个，字段映射逻辑都只取决于结构体标签，跟 Bind 方法无关
json:"user_name" 就万事大吉，却忘了字段本身还得导出（首字母大写），否则标签根本不起作用。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
