如何自定义 Go 结构体字段的默认序列化命名规则（JSON/BSON 小驼峰）-Golang-PHP中文网

go 默认使用 pascalcase 字段名直接映射为 json/bson 键名，但可通过结构体标签显式指定小驼峰（camelcase）格式；虽无法全局修改标准库的默认行为，但借助代码生成或约定式命名可避免重复书写标签。

go 默认使用 pascalcase 字段名直接映射为 json/bson 键名，但可通过结构体标签显式指定小驼峰（camelcase）格式；虽无法全局修改标准库的默认行为，但借助代码生成或约定式命名可避免重复书写标签。

在 Go 中，json 和 bson 标签用于控制结构体字段在序列化/反序列化时的键名。默认情况下，Go 的 encoding/json 和主流 BSON 库（如 go.mongodb.org/mongo-driver/bson）均采用“原样导出字段名”策略：首字母大写的导出字段（如 JdId）会直接转为 "JdId"，而非自动转换为小驼峰形式（如 "jdId"）。Go 语言本身不提供运行时或编译期的全局配置来改变这一默认行为——这意味着你无法通过设置环境变量、导入配置包或修改标准库来让 json:"..." 或 bson:"..." 标签“自动推导”小驼峰命名。

因此，若希望 JdId → "jdId"、AcceptTimestamp → "acceptTimestamp"，唯一符合 Go 生态规范的方式是显式声明标签：

type CvJdRelationInfo struct {
    JdId            string `json:"jdId" bson:"jdId"`
    CvId            string `json:"cvId" bson:"cvId"`
    Status          int16  `json:"status" bson:"status"`
    AcceptTimestamp int64  `json:"acceptTimestamp" bson:"acceptTimestamp"`
}

✅ 注意事项：

cn-json-diff

比较两个 JSON 文件并显示差异。支持嵌套结构、数组及值变更。纯 Python 标准库实现，无需 API 密钥。

下载

标签值区分大小写，"jdId" 与 "jdid" 不同；
若同时使用 json 和 bson，建议保持键名一致，便于 API 统一和调试；
bson 标签中若省略（如未写 bson:"..."），MongoDB 驱动默认使用字段名小写形式（jdid），但这与 json 行为不一致，易引发混淆，不推荐依赖此隐式规则。

? 进阶建议：
为避免手动重复编写标签，可采用以下工程化方案：

使用代码生成工具（如 stringer 思路衍生的自定义 generator），基于字段名自动注入 camelCase 标签；
在团队内约定结构体字段命名即为序列化键名（例如直接定义 JdId 为 JdId，但 JdId 改为 Jdid —— ❌ 不推荐，破坏 Go 命名惯例且影响可读性）；
使用支持标签推导的第三方序列化库（如 mapstructure 配合自定义 TagName，但仅适用于解码场景，不替代 json.Marshal）。

总结：Go 的设计哲学强调显式优于隐式，因此“省略标签即得理想命名”不可行。务实做法是——接受显式标签的必要性，并通过工具链将其自动化，从而兼顾清晰性、可维护性与开发效率。