json.Marshal 比 reflect 手动拼接更安全，因其内置 nil 处理、转义、时间格式、自定义 MarshalJSON 和循环检测；手动拼接易出错且不可靠。
为什么 json.Marshal 通常比 reflect 手动拼接更安全
直接用 json.marshal 处理结构体或 map 是 go 中生成 json 响应的标准做法。它已深度优化、处理了 nil 指针、时间格式、自定义 marshaljson 方法、循环引用检测等边界情况。手动用 reflect 构建 json 字符串（比如逐字段拼接 "key":"value"）极易出错：转义遗漏、类型误判、嵌套对象/数组结构混乱，且无法复用标准库的编码逻辑。
除非你有非常特殊的序列化需求（如字段名动态计算、运行时拦截字段、绕过 struct tag），否则不建议用 reflect “从零造 JSON”。真正需要动态控制时，优先考虑组合 json.Marshal 和反射元数据，而非自己写 JSON 序列化器。
如何用 reflect 动态提取字段并交由 json.Marshal 编码
典型场景：HTTP 接口需根据查询参数（如 fields=name,email）只返回指定字段。这时可用 reflect 查看结构体字段名和值，过滤后构造一个临时 map，再交给 json.Marshal —— 安全、简洁、可读。
- 用
reflect.TypeOf获取结构体类型，遍历NumField，检查Tag.Get("json")得到导出字段名（注意忽略-和空 tag） - 用
reflect.ValueOf获取值，对每个字段调用.Interface()提取可序列化的 Go 值（避免直接操作reflect.Value传给json.Marshal） - 构建
map[string]interface{}，只存用户请求的字段名及其值；若字段未导出，reflect.Value的.CanInterface()会返回 false，应跳过 - 最终对这个 map 调用
json.Marshal，不是对原始 struct
func dynamicJSON(v interface{}, allowedFields map[string]bool) ([]byte, error) {
rv := reflect.ValueOf(v)
if rv.Kind() == reflect.Ptr {
rv = rv.Elem()
}
if rv.Kind() != reflect.Struct {
return nil, errors.New("only struct supported")
}
out := make(map[string]interface{})
rt := reflect.TypeOf(v)
if rt.Kind() == reflect.Ptr {
rt = rt.Elem()
}
for i := 0; i < rv.NumField(); i++ {
field := rt.Field(i)
value := rv.Field(i)
if !value.CanInterface() {
continue
}
jsonTag := field.Tag.Get("json")
if jsonTag == "-" {
continue
}
key := strings.Split(jsonTag, ",")[0]
if key == "" {
key = field.Name
}
if allowedFields[key] {
out[key] = value.Interface()
}
}
return json.Marshal(out)
}
哪些字段会被 reflect 漏掉或误读
反射在结构体字段访问上存在几个隐性限制，直接影响 JSON 输出是否符合预期：
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
- 未导出字段（首字母小写）：即使用了
json:tag，reflect.Value.Field(i)对应的CanInterface()返回 false，无法取值，json.Marshal本身也会跳过它们 —— 反射行为与标准编码一致，但容易误以为“tag 生效了就能取” - 嵌套结构体指针为 nil：
value.Interface()返回nil，json.Marshal会输出null；若想省略该字段，需额外判断value.Kind() == reflect.Ptr && value.IsNil() - 匿名字段（内嵌）：若未显式设置
json:tag，默认展开为平级字段；但reflect遍历时仍按声明顺序出现，需注意 tag 解析逻辑是否覆盖了匿名字段 - 接口类型字段（如
interface{}）：反射能拿到值，但运行时类型决定实际编码结果；若存的是自定义类型且未实现MarshalJSON，可能触发默认行为（如 map → object，slice → array）
性能与调试陷阱：别在热路径反复做 reflect.TypeOf
reflect.TypeOf 和 reflect.ValueOf 在每次调用时都有一定开销，尤其对高频 API 响应。更严重的是，如果在 handler 内每次都重新解析 struct tag，等于放弃编译期确定的字段信息。
- 把
reflect.Type和字段映射（如map[string]int字段索引）缓存到包变量或结构体字段中，首次访问后复用 - 避免在循环内对同一类型反复调用
reflect.TypeOf(x)；改用一次获取 + 多次Value.Field(i) - 调试时打印
rv.Kind()和rv.Type().Name()，比盲目假设“这肯定是个 struct”更可靠；常见错误是传入了nilinterface{} 或未解引用的指针，导致rv.Kind()是reflect.Invalid
动态 JSON 的复杂点不在“怎么拼字符串”，而在于字段可见性、运行时类型稳定性、以及缓存与热更新之间的权衡——这些细节一旦漏掉，问题往往出现在上线后特定用户请求上，而不是本地测试时。
