go结构体字段首字母小写会导致mongodb存储失败和json序列化为空，因反射仅访问导出字段；必须将字段名改为首字母大写（如name→name），标签无效；嵌套结构体和匿名字段同理，需确保类型及字段均导出。
Go结构体字段小写导致MongoDB存不进数据
Go里结构体字段如果首字母小写，mgo、mongo-go-driver这类驱动根本读不到它——不是报错，是静默忽略。因为驱动靠反射访问字段，而反射只能看到“导出字段”，也就是首字母大写的。
- 常见错误现象：
InsertOne成功返回，但数据库里对应字段为空或缺失，struct{ name string }写进去后name字段压根没存 - 必须改成
Name string，哪怕业务上它本该是私有字段 - 如果真要隐藏字段逻辑，用两个结构体：一个带大写字段用于DB操作，一个带小写字段用于内部业务处理
- 标签（如
`bson:"name"`或`json:"name"`）不能绕过可见性限制——字段本身不可见，标签再全也没用
JSON序列化失败：小写字段在json.Marshal里消失
json.Marshal 和 json.Unmarshal 同样依赖反射，只处理导出字段。小写字母开头的字段不会出现在JSON输出中，也不会从JSON输入中被赋值。
- 示例：
type User { name string `json:"name"` }→json.Marshal(User{"Alice"})返回{}，不是{"name":"Alice"} - 修复只需改
name为Name，标签可保留不变 - 注意：即使加了
json:",omitempty"，字段也得先“可见”才能参与序列化 - 测试时别只看
err == nil，一定要检查输出字节内容是否符合预期
为什么Go不用public/private关键字？
这不是偷懒，而是设计取舍：用大小写统一控制所有导出行为（变量、函数、类型、方法、结构体字段），避免语言层面增加冗余语法，也让包边界更清晰。
- 包内所有标识符互相可见，无论大小写；跨包调用只认大写开头的名称
- 小写字段不是“安全保护”，只是封装提示——同包内代码仍可随意读写它
- 如果你在包A里定义了
type Config struct { timeout int }，包B导入后无法访问cfg.timeout，但能访问cfg.Timeout（只要它存在） - 接口实现也不受影响：小写方法不能被外部调用，但只要满足接口签名，仍算实现了该接口
容易被忽略的陷阱：嵌套结构体和匿名字段
嵌套结构体里的小写字段，照样不可导出；匿名字段如果是小写类型，它的字段也不会自动提升为导出字段。
立即学习“go语言免费学习笔记（深入）”；
- 错误写法：
type DBUser struct { user User }，其中User是小写类型 →DBUser的user字段不可导出，整个嵌套失效 - 正确做法：确保嵌套类型名首字母大写，且其内部字段也大写；或者显式命名并导出：
User User `bson:"user"` - 匿名字段只有在类型名大写时才可能“提升”字段可见性，但提升规则严格：仅当匿名字段是导出类型，且其字段名本身也导出，才会被外部看到
- 最稳妥的方式：永远显式命名字段，不依赖匿名字段的字段提升
大小写不是风格偏好，是Go运行时反射和序列化的硬性开关。写结构体时第一反应不该是“语义上该不该公开”，而是“这个字段会不会被JSON、bson、HTTP、gRPC这些机制用到”——只要会，就必须大写。
