Golang反射获取结构体字段 Golang结构体反射操作示例_网络技术

安全获取结构体字段值需先确认是导出字段且v为可寻址的struct；用Field(i)前须v.Elem()解指针并验证v.Kind()==reflect.Struct，索引从0开始；按名取用FieldByName避免panic；修改值必须传指针并检查CanSet()。

直接调用 Field 方法前必须确保目标是导出字段（首字母大写），否则会 panic。反射无法读取未导出字段的值，哪怕你用 reflect.Value.Elem() 解引用后也一样。

常见错误现象：panic: reflect: Field of non-struct type 或 panic: reflect: Field index out of bounds，通常是因为传入了指针但没先调用 Elem()，或索引越界。

reflect.StructField 是类型层面的元数据（只读、无值），包含 Name、Type、Tag、Index；而 reflect.Value 对应的是运行时的实际值（可读可写，但受导出性限制）。

典型误用：试图从 StructField 直接读值 —— 它根本没有 Interface() 方法。必须通过 reflect.Value.Field(i) 或 FieldByName 拿到 Value 实例后再操作。

获取 tag：用 sf.Tag.Get("json")，不是 sf.Tag["json"]（后者是语法错误）
判断是否导出：看 sf.PkgPath != ""，空字符串才表示导出字段
修改字段值的前提：该 reflect.Value 必须是可寻址的（v.CanAddr()）且可设置（v.CanSet()），通常意味着原始变量不能是字面量或临时值

这个错误几乎都源于你传给反射的值本身不可寻址 —— 比如直接传 struct 字面量、函数返回的 struct 值、或没取地址的局部变量。

正确做法永远是传指针：reflect.ValueOf(&myStruct)，然后 .Elem() 进入结构体内部再操作字段。

不要写 reflect.ValueOf(myStruct).Field(0).SetInt(42) —— 这里 myStruct 是副本，不可寻址
要写 reflect.ValueOf(&myStruct).Elem().Field(0).SetInt(42)
如果字段本身是指针类型（如 *string），Set 时需传 reflect.ValueOf(&someString)，不能传 reflect.ValueOf(someString)
对非导出字段调用 Set* 方法会静默失败（不 panic，但值不变），务必用 CanSet() 预检

这在实现通用 reset、mock 初始化或 deep-copy 前清空时很常用，但要注意字段类型差异和零值语义。

核心逻辑是：对每个字段，先判断

是否可设置，再根据其底层类型调用对应 Set* 方法，或统一用 Set(reflect.Zero(v.Type()))。

reflect.Zero(v.Type()) 最稳妥，它返回该类型的零值 reflect.Value，适配所有类型（包括自定义类型、interface{}、func）
避免手动写 SetInt(0)、SetString("") 等分支 —— 类型一多就漏，且无法处理嵌套结构体或指针
若字段是 slice/map/channel，reflect.Zero 返回 nil，符合预期；若需空切片而非 nil，得单独判断 v.Kind() == reflect.Slice 后用 reflect.MakeSlice
注意循环中修改字段可能影响后续字段的类型判断（比如某字段是函数，执行后改变了状态），一般 reset 场景下无副作用，但要心里有数

反射操作字段的边界非常清晰：导出性决定可读性，可寻址性决定可写性，类型一致性决定 Set* 是否合法。绕不开的检查（CanInterface、CanSet、Elem 调用时机）不是冗余，而是 Go 反射模型本身的约束体现。