Go结构体输出：10分钟从新手到专家

为什么在Go中“直接打印结构体”并不简单？

想象一下：你用Go编写代码，创建了一个漂亮的User结构体，填充了数据，然后想看看里面有什么。你写下fmt.Println(user)，却看到类似{Alex 25 true}的内容。信息量够吗？不太够。如果有15个字段呢？如果其中一个字段是嵌套结构体呢？如果是一个结构体切片呢？

Stack Overflow上关于"How to print struct variables in console?"的问题获得了数千次浏览，这并非偶然。每个Golang新手（甚至老手）都会遇到标准结构体输出只是一串没有字段名的枯燥字符串的情况。而当项目规模扩大时，调试就变成了猜谜游戏。

在本文中，我们将全面讲解在Go控制台输出结构体的所有方法：从基础到高级。你将学习如何美观地输出结构体，包括字段名、JSON格式，甚至如何编写自己的打印方法。我们开始吧！

▎1. 最简单的方法：fmt.Println及其局限性

让我们从基础开始。我们有一个结构体：

package main\n\nimport "fmt"\n\ntype User struct {\n    Name   string\n    Age    int\n    Active bool\n}\n\nfunc main() {\n    u := User{Name: "安娜", Age: 30, Active: true}\n    fmt.Println(u)\n}\n

输出：\n

{安娜 30 true}

虽然能工作，但信息量不足。你看不到哪个值对应哪个字段。如果结构体有10个字段，你只能猜测哪个是哪个。特别是当数据类型重复时（例如，连续两个string字段）。

结论： fmt.Println仅适用于快速检查，且结构体很小、你确切记得字段顺序的情况。

何时有用？

\n
• 你正在编写一次性脚本。
\n
• 结构体包含2-3个不同类型的字段。
\n
• 你在日志中使用fmt.Println，更注重速度而非可读性。
\n

▎2. 救星%+v：带字段名的打印

这可能是Stack Overflow上最流行的答案。在fmt.Printf中使用%+v格式可以输出带字段名的结构体：

fmt.Printf("%+v\\n", u)\n

输出：\n

{Name:安娜 Age:30 Active:true}

好多了！你可以清楚地看到姓名、年龄和状态。

fmt还有哪些其他格式？

\n
• %v — 标准表示（与Println相同）。
\n
• %+v — 带字段名。
\n
• %#v — 完整表示，包含包名和类型（见下文）。
\n
• %T — 仅输出变量类型。
\n

%#v示例：

fmt.Printf("%#v\\n", u)\n// main.User{Name:"安娜", Age:30, Active:true}\n

这种格式在你想要复制输出并粘贴回代码时非常有用——它是有效的结构体字面量初始化。

建议：记住%+v组合——这是你在Go中调试结构体时的常用工具。

▎3. 美观与有序：JSON序列化

当结构体很大、嵌套或包含切片时，%+v可能变得难以阅读。这时JSON就派上用场了。Go标准支持将结构体转换为JSON：

package main\n\nimport (\n    "encoding/json"\n    "fmt"\n)\n\ntype Address struct {\n    City  string `json:"city"`\n    Street string `json:"street"`\n}\n\ntype User struct {\n    Name    string  `json:"name"`\n    Age     int     `json:"age"`\n    Active  bool    `json:"active"`\n    Address Address `json:"address"`\n}\n\nfunc main() {\n    u := User{\n        Name:   "伊万",\n        Age:    28,\n        Active: true,\n        Address: Address{\n            City:   "莫斯科",\n            Street: "特维尔大街",\n        }