脱敏发生在运行时数据序列化阶段（如json.Marshal），而非打包时；需通过go:generate生成Redact()方法或自定义ResponseWriter中间件实现，且必须显式调用或注册，打包命令本身不参与脱敏逻辑。
打包时无法自动脱敏，必须在序列化出口控制
Go 模块打包（go build 或 go install）本身不参与运行时数据序列化，也不会触碰结构体字段值或 JSON 输出。所谓“打包时自动脱敏”是个常见误解——脱敏发生在数据**被写出的那一刻**，比如 json.Marshal、http.ResponseWriter.Write、zap.Any 调用时，而不是编译或打包阶段。
试图在 go:generate 或构建脚本里做字符串替换、正则扫源码、修改 struct tag 值，不仅无效，还会污染代码语义、破坏 IDE 跳转、让 go vet 报错。
- 打包只是把已编译的机器码和符号表打成二进制或 .a 文件，不执行任何业务逻辑
- 敏感字段是否脱敏，取决于你是否实现了
MarshalJSON、MarshalLogObject等接口，跟打包命令无关 - 如果你依赖外部 DLP 工具（如
godlp），它也是在运行时加载 YAML 规则并解析输入数据，不是在打包期生效
真正起作用的是 go:generate 生成脱敏方法，不是打包动作
go:generate 是预编译步骤，它能扫描 struct tag（如 secure:"phone,mask"），为结构体生成静态 Redact() 方法。这个过程发生在 go generate 手动触发或 CI 中显式调用时，**不是 go build 自动触发的**。
生成的代码直接访问字段，无反射开销，且类型安全。例如：
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
type User struct {
ID int `json:"id"`
Phone string `secure:"phone,mask"`
IDCard string `secure:"id_card,mask:8"`
}运行 go generate ./... 后，会生成类似：
func (u *User) Redact() *User {
if u == nil {
return nil
}
u.Phone = u.Phone[:3] + "****" + u.Phone[len(u.Phone)-4:]
u.IDCard = u.IDCard[:6] + "********" + u.IDCard[len(u.IDCard)-4:]
return u
}- 必须手动加
//go:generate go run gen_redact.go注释到结构体上方 - 生成器需自己写（可用
golang.org/x/tools/go/packages解析 AST），不能靠go build自带功能 - 生成的
Redact()方法仍需你在 handler / log / RPC 返回前显式调用，比如c.JSON(200, user.Redact())
HTTP 响应脱敏必须包装 ResponseWriter，不能靠打包配置
gin/echo 等框架的 c.JSON() 底层仍是调用 json.Marshal + Write()。如果你没实现 MarshalJSON，也没在返回前调用 Redact()，那无论怎么打包，响应体都是明文。
唯一能“无感”脱敏 HTTP 响应的方式，是自定义 http.ResponseWriter 实现，在 Write([]byte) 里流式解析 JSON 并按 key 路径（如 user.phone）注入掩码。但这需要你在启动时注册中间件，例如：
func SecureResponseMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
sw := &secureWriter{ResponseWriter: w}
next.ServeHTTP(sw, r)
})
}- 该中间件必须在路由注册前启用，否则不生效
- 它只对
Content-Type: application/json生效，其他类型（如 text/html）跳过 - 不要用
io.ReadAll全量读 body 再改——内存爆炸风险高；要用json.Decoder.Token()流式处理 - 打包时不可能自动插入这种中间件，必须代码里显式装配
容易被忽略的点：omitempty 和空值掩码冲突
很多结构体字段带 json:",omitempty"，但脱敏后设为空字符串 "" 或零值 0，会导致字段直接从 JSON 中消失，前端报 undefined 错误。
这不是打包问题，而是脱敏逻辑设计缺陷：
- 手机号脱敏别写
u.Phone = ""，改用u.Phone = "*** **** ***"或"[REDACTED]" - 如果字段类型是
int64（如身份证号存为数字），脱敏不能赋0，得先转成字符串再掩码 - 嵌套结构体字段（如
User.Profile.Phone）若Profile是 nil，u.Profile.Phone = "..."会 panic，必须先判空 - 第三方库（如
github.com/goccy/go-json）默认跳过零值字段，脱敏前得确认它是否兼容你的掩码策略
