代码生成反射拷贝性能优于手写反射拷贝，因其在构建期生成强类型专用函数，绕过运行时反射开销，支持tag控制、nil安全与类型校验；如CopyPerson函数直接赋值字段并显式处理指针、切片、map等。
为什么手写反射拷贝不如代码生成
反射拷贝在运行时动态判断类型、遍历字段、递归处理，每次调用都要走完整反射路径——reflect.Value.Kind()、Field(i)、CanSet()、Set() 等操作开销大，且无法被编译器内联或优化。而代码生成（CodeGen）在构建期就为具体结构体生成专用拷贝函数，完全绕过反射，性能接近手动赋值，还能保留字段校验、tag 控制、零值处理等逻辑。
codegen 生成的拷贝函数长什么样
以 Person 结构体为例，生成的函数不是泛型或 interface{} 入参，而是强类型签名：
func CopyPerson(dst *Person, src *Person) {
if src == nil {
*dst = Person{}
return
}
dst.Name = src.Name
dst.Age = src.Age
if src.Addr == nil {
dst.Addr = nil
} else {
if dst.Addr == nil {
dst.Addr = &Address{}
}
dst.Addr.City = src.Addr.City
dst.Addr.Zip = src.Addr.Zip
}
dst.Emails = append(dst.Emails[:0], src.Emails...)
dst.Metadata = copyMapStringInterface(src.Metadata)
}
关键点：
- 字段名、类型、是否指针/切片/映射全部静态确定，无
reflect.Value封装开销 - 切片用
append(dst[:0], src...)复用底层数组（可选），map 用独立辅助函数隔离逻辑 - nil 检查和初始化逻辑显式展开，避免运行时 panic
- struct tag（如
copier:"skip"或json:"-"）在生成时已解析并跳过对应字段
用 go:generate + structfield 驱动代码生成
不依赖外部模板引擎，用标准库 go/parser 和 go/types 解析源码，配合 golang.org/x/tools/go/packages 获取 AST 和类型信息。核心步骤：
立即学习“go语言免费学习笔记（深入）”；
- 定义标记注释：在目标结构体上方加
//go:generate go run ./gen -type=Person - 编写生成器：读取
packages.Load结果，定位Person类型，遍历其StructField - 对每个字段，检查
field.Tag.Get("copier")是否为"skip"，或field.Tag.Get("json")是否以"-"开头 - 按字段 Kind 分支生成语句：
reflect.Int→ 直接赋值，reflect.Ptr→ 加 nil 判断和解引用，reflect.Slice→append或make+ 循环 - 输出到
person_copy.go，文件头带// Code generated by go:generate; DO NOT EDIT.
codegen 容易被忽略的边界细节
生成器不是“写完就能跑”，以下几点不处理就会导致静默错误或 panic：
- 嵌套结构体未导出字段（如
type Inner struct { name string }）——生成代码里不会出现该字段，但若父结构体字段类型是*Inner，需确保生成函数中不尝试访问src.Inner.name（会编译失败） - 接口类型（
interface{}）无法静态推导底层类型，必须降级为反射处理，或约定只支持encoding.TextMarshaler等有限接口 - 循环引用（A → B → A）在生成期无法检测，只能靠运行时加 map 缓存；codegen 通常不处理，需文档明确标注“不支持”
- 字段类型别名（
type UserID int64）和基础类型（int64）在 AST 中类型名不同，但赋值兼容——生成器要调用types.Identical判断可赋值性，而非简单比字符串
真正省事的不是生成动作本身，而是把字段可见性、tag 解析、类型兼容性这些 runtime 才暴露的问题，提前压到 build 阶段报错。
