Go结构体中添加自定义字段需先用type定义新命名类型（如type Email string），再将其作为字段类型；若需JSON序列化自动转换，必须实现json.Marshaler和json.Unmarshaler接口；带约束的字段应通过构造函数校验并封装访问。
Go 结构体里怎么加自定义字段（不是基础类型）
Go 没有“字段类型随意声明”的语法糖，所谓“自定义字段”，本质是让结构体字段持有你定义的类型——要么是 type 定义的新命名类型，要么是带方法的结构体，甚至接口。关键不在“加字段”，而在“字段类型是否可控”。
常见错误是直接写 var Name myString 却没定义 myString，或误以为能像 Python 那样动态挂字段。
- 必须先用
type声明新类型（哪怕底层是string或int），才能把它当字段类型用 - 如果想为字段附加行为（比如校验、序列化逻辑），得给这个自定义类型实现方法，而不是挂在结构体上
- 避免用
interface{}当字段类型来“模拟动态字段”——它会丢失类型信息，后续访问必须断言，容易 panic
type Email string
func (e Email) IsValid() bool {
return strings.Contains(string(e), "@")
}
type User struct {
Name string
Email Email // ← 这才是“自定义字段”：类型是 Email，不是 string
}
想让字段支持 JSON 序列化时自动转换怎么办
字段类型是自定义的，但 json.Marshal 默认只认基础类型和标准组合（如 map、[]T）。不加处理，Email 会被当成 string 输出，但反序列化时不会自动转成 Email 类型。
解决路径只有一条：实现 json.Marshaler 和 json.Unmarshaler 接口。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 只要实现了这两个接口，
json.Marshal就会调用你的MarshalJSON()方法，而不是默认逻辑 - 注意
UnmarshalJSON([]byte)必须能处理原始输入（比如可能是"user@domain.com"字符串），不能依赖结构体字段已初始化 - 别在
MarshalJSON里返回nil, err以外的错误，否则整个结构体序列化会失败
func (e *Email) UnmarshalJSON(data []byte) error {
var s string
if err := json.Unmarshal(data, &s); err != nil {
return err
}
if !strings.Contains(s, "@") {
return fmt.Errorf("invalid email format")
}
*e = Email(s)
return nil
}
字段要带单位或约束（比如“非负整数”“秒级时间戳”）怎么建模
用基础类型（如 int、int64）存，运行时无法阻止非法值写入；靠文档或注释说明约束，没人保证遵守。真正靠谱的做法是把约束编码进类型本身。
- 定义新类型后，在构造函数（非强制但推荐）里做校验，禁止直接字面量赋值
- 把字段设为小写（如
seconds int64），只通过公开方法访问，确保每次读写都受控 - 不要试图在结构体字段上加 tag 来表达业务约束（如
`validate:"gte=0"`）——那是运行时反射检查，不防编译期错误
type Seconds int64
func NewSeconds(v int64) (*Seconds, error) {
if v < 0 {
return nil, errors.New("Seconds must be non-negative")
}
s := Seconds(v)
return &s, nil
}
type Config struct {
Timeout *Seconds `json:"timeout"`
}
为什么不能直接用 map[string]interface{} 模拟“动态字段”
看起来灵活，实际埋雷：字段名拼错、类型断言失败、IDE 无法跳转、单元测试难覆盖。尤其当多个地方读写同一个 key（比如 "metadata"）时，改一个地方漏一个地方，运行时报 panic: interface conversion: interface {} is string, not int 是常态。
- 如果真需要键值对，明确字段类型为
map[string]string或map[string]json.RawMessage，至少类型安全 - 若字段集合固定但值类型不同（如同时存
string、bool、float64），优先考虑用具体结构体字段，而不是塞进 map - 只有在完全无法预知字段名和类型的场景（比如通用 webhook 解析器），才用
map[string]interface{}，且必须配完整校验逻辑
最常被忽略的一点：自定义字段的“自定义”不是指语法炫技，而是指把业务语义、约束、行为封装进类型——类型即契约。少一层类型包装，就多一分运行时不确定性。
