gconv 的 string 转结构体核心逻辑是先尝试按 JSON 解析失败则尝试其他格式。---一、支持的字符串格式格式 示例 说明JSON {name:张三,age:20} 最常用标准做法XML username张三/name/user 需包含 XML 标签特征YAML name: 张三\nage: 20 需包含 YAML 特征冒号换行TOML name 张三 需包含 TOML 特征INI [user]\nname张三 需包含 INI 特征URL Query name张三age20 需包含 或 纯字符串 张三 只能映射到单个 string 字段的结构体---二、核心方法// 方式1直接转换推荐jsonStr : {name:张三,age:20,is_vip:true}var user Usererr : gconv.Struct(jsonStr, user)// 方式2带默认值var user2 Usergconv.Struct(jsonStr, user2) // 失败时 user2 保持零值// 方式3转换到指针var userPtr *Usergconv.Struct(jsonStr, userPtr) // 自动创建实例并赋值---三、完整示例package mainimport (fmtgithub.com/gogf/gf/v2/util/gconv)type User struct {Id int json:idName string json:nameAge int json:ageIsVip bool json:is_vipScore float64 json:scoreAddress *Address json:address // 嵌套结构体}type Address struct {City string json:cityStreet string json:street}func main() {// JSON 字符串jsonStr : {id: 1,name: 张三,age: 25,is_vip: true,score: 98.5,address: {city: 北京,street: 长安街}}var user Usererr : gconv.Struct(jsonStr, user)if err ! nil {fmt.Println(转换失败:, err)return}fmt.Printf(%v\n, user)// 输出: {Id:1 Name:张三 Age:25 IsVip:true Score:98.5 Address:0xc000...}fmt.Printf(城市: %s\n, user.Address.City) // 北京}---四、非 JSON 格式示例XML 字符串xmlStr : username张三/nameage20/age/uservar user Usergconv.Struct(xmlStr, user) // 自动识别 XML 格式URL Query 字符串queryStr : name张三age20is_viptruevar user Usergconv.Struct(queryStr, user) // 自动解析 query 参数---五、关键特性与注意事项特性 说明自动格式识别 无需指定格式gconv 内部自动判断字段标签兼容 支持 json/xml/gconv 等标签不区分大小写嵌套支持 JSON/XML 中的嵌套对象自动映射到嵌套结构体指针自动创建 目标是指针字段时自动 new()类型容错 20 → int(20)true → bool(true)忽略未知字段 JSON 中有但 struct 中没有的字段静默忽略零值处理 转换失败时返回零值不会 panic---六、常见坑1. JSON 字段名不匹配type User struct {UserName string json:user_name // 标签必须匹配 JSON key}// 错误JSON 中是 username但标签是 user_namejsonStr : {username:张三}// 结果UserName 为空字符串零值不报错2. 大小写问题// 虽然不区分大小写但建议保持标签与 JSON key 一致jsonStr : {UserName:张三} // 也能映射到 user_name 标签3. 时间字段type User struct {CreateTime *gtime.Time json:create_time // 用 gtime.Time 而非 time.Time}jsonStr : {create_time:2024-01-01 12:00:00}// gconv 会自动解析多种时间格式---七、与标准库对比场景 标准库 json.Unmarshal gconv.Struct严格类型检查 ✓ 类型不匹配报错 ✗ 尽量兼容转换多格式支持 仅 JSON JSON/XML/YAML/Query 等字段标签 仅 json json/xml/gconv/orm大小写敏感 敏感标签必须精确匹配 不区分大小写嵌套指针 需手动初始化 自动创建性能 略快 略慢功能更丰富---如果你有具体的字符串样例和结构体定义贴出来我可以帮你分析为什么转换失败或字段映射不上。
