%+v是调试结构体最简、最安全、最通用的方式,因其保留字段名、清晰辨识nil、兼顾可读性;但仅输出导出字段,不适用日志或API响应等生产场景。

直接用 fmt.Printf("%+v", structVar),这是最简、最安全、最通用的方式。
为什么不用 %v 或 %#v
用 %v 会丢字段名,比如 {123 "foo" true},你根本看不出哪个是 ID、哪个是 Name;%#v 虽然带类型和包路径(如 main.User{ID:123, Name:"foo"}),但对 nil 切片或 map 显示为 nil,而 %v 可能只输出空 [] 或 {},容易误判为空集合。只有 %+v 在字段名、可读性、nil 辨识三者间取得平衡,专为调试结构体设计。
%+v 的实际使用限制与注意事项
它只输出导出(首字母大写)字段,私有字段(小写开头)不会出现,这是 Go 的访问控制机制决定的,不是 bug;它不递归展开嵌套结构体的未导出字段,但对导出的嵌套 struct、slice、map、time.Time 等仍保持清晰格式;如果结构体含大量二进制数据(如 []byte),%+v 会原样打印一长串数字,影响可读性——此时应考虑自定义 String() 方法或用专用工具。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
什么时候该放弃 %+v 改用其他方式
- 需要隐藏敏感字段(如密码、密钥)时,
%+v无过滤能力,必须实现Stringer接口或手动构造日志字符串 - 输出要被下游程序解析(如 JSON/YAML),不能依赖
%+v的文本格式,应走json.MarshalIndent或yaml.Marshal - 结构体字段值本身是不可见字符(如含 \x00、\r\n 混排的 []byte),
%+v输出会混乱,建议用%q单独格式化该字段 - 需要固定列宽、对齐或加颜色的 CLI 表格输出,
%+v不适用,得用text/tabwriter或tablewriter
真正难的不是“怎么打出字段”,而是“打出来之后要不要、能不能被人或程序可靠地理解”——%+v 解决了 80% 的调试场景,但它的边界非常明确:仅限开发期人工阅读,绝不该出现在日志采集管道或 API 响应中。
立即学习“go语言免费学习笔记(深入)”;

















