Go结构体字段名编译期固定不可改，但可通过json标签控制序列化键名，如json:"user_name"；错误写法如空格或引号不当会导致标签失效；嵌套与匿名字段需单独标注，动态场景应实现MarshalJSON方法或用map。
结构体字段名改不了，但 JSON 输出可以换名字
Go 的反射不能修改结构体字段本身的名称（那是编译期固定的），但你能控制它在 json.Marshal 时输出的键名——靠的是结构体标签（struct tag）。很多人卡在这儿，以为得用反射去“重命名字段”，其实完全没必要。
常见错误现象：json.Marshal 输出的 key 和字段名一样，比如 UserName 输出成 "UserName"，但 API 要求是 "user_name"；试过反射改字段名，结果 panic 或毫无效果。
- 结构体字段名是 Go 语言符号，运行时不可变，
reflect.StructField.Name是只读字段 - JSON 序列化走的是
encoding/json包的 marshal 流程，它优先读取json:标签，没标签才 fallback 到字段名 - 标签值支持
omitempty、-（忽略）、别名，还支持带空格的字符串（需用双引号包裹）
怎么写 json 标签才不踩坑
标签写错一个字符就失效，而且 IDE 不报错、运行也不报错，只是默默忽略你的设置。最常出问题的是空格、引号、拼写。
- 必须用反引号（
`）包裹整个 tag 字符串，不能用双引号或单引号 -
json后面紧跟冒号，**不能有空格**：✅`json:"user_name"`，❌`json: "user_name"` - 要忽略空值？加
omitempty，但注意它只对零值生效（""、0、nil），不是nil指针也照常输出 - 想彻底跳过某个字段？用
-：`json:"-"`，比omitempty更彻底
示例：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
type User struct {
ID int `json:"id"`
UserName string `json:"user_name"`
IsActive bool `json:"is_active,omitempty"`
Password string `json:"-"`
}
嵌套结构体和匿名字段的 JSON 别名容易漏掉
嵌套结构体不会自动继承外层标签，每个字段都得单独标。匿名字段（内嵌）默认会“提升”字段，但一旦加了 json 标签，就按标签走，不再提升。
- 匿名字段想保持扁平化输出？别加
json标签，或者显式写成`json:",inline"` - 加了
inline后，它的字段会和外层结构体字段同级，但如果同名，外层字段会覆盖内层 - 如果嵌套结构体本身也有
json标签，那它的字段名就是它自己标签定义的，跟外层无关
比如：
type Base struct {
CreatedAt time.Time `json:"created_at"`
}
type Article struct {
Base
Title string `json:"title"`
// 此时 JSON 输出是 {"created_at": "...", "title": "..."} —— 因为 Base 是匿名字段且没被屏蔽
}
想动态改 JSON key？别硬刚反射，用中间结构体或自定义 MarshalJSON
真有运行时才知道 key 名的场景（比如多租户字段映射），别试图用反射去改 struct tag——它在运行时是只读字符串，改了也没用。可行路径只有两条：
- 用
map[string]interface{}构造最终输出，字段名由变量控制，适合简单场景 - 为结构体实现
MarshalJSON() ([]byte, error)方法，在里面手动组装 map 并序列化，灵活但要小心循环引用 - 第三方库如
mapstructure或easyjson可辅助，但引入复杂度，小项目不推荐
例如自定义序列化：
func (u User) MarshalJSON() ([]byte, error) {
type Alias User // 防止无限递归
return json.Marshal(struct {
Alias
CustomName string `json:"name"`
}{
Alias: (Alias)(u),
CustomName: u.UserName,
})
}
最易被忽略的一点：struct tag 的解析发生在 json.Marshal 内部，不是反射调用触发的；你看到的 “反射能操作 tag” 其实只是读取，不能写。所有想“动态改字段名”的尝试，本质都是绕开 struct tag 去构造新数据结构。
