必须实现fmt.stringer接口才能让fmt.println等显示结构体可读内容，因为默认输出仅显示内存地址或原始字段堆砌；%#v无法解引用指针，仍只显示地址；string()方法需用指针接收者、判空、手动解引用并保护nil指针。
Go 里想让 fmt.Println 或 fmt.Printf("%v", v) 打印结构体时显示可读内容（比如指针字段解引用、字段重命名、隐藏敏感字段），不是靠改格式动词，而是必须实现 fmt.Stringer 接口 —— 否则默认输出要么是内存地址，要么是原始字段堆砌，调试时根本没法快速定位问题。
为什么 %#v 不能解决指针字段的调试需求
%#v 确实能输出 Go 语法风格的值，但它对指针类型只显示地址：(*string)(0xc000010240)。你无法一眼看出这个指针是否为 nil，更看不到它指向的字符串内容是什么。结构体中混着 *string、*int、map[string]*T 时，%#v 输出完全不可读。
常见错误现象：
- 日志里看到一堆
0x...，得额外加fmt.Println(*ptr)才能确认值 - 单元测试失败时 diff 显示的是地址差异，而非语义差异
- 用
pprof或调试器 inspect 值时，仍需手动展开每层指针
这不是格式动词的问题，是 Go 的默认反射逻辑不递归解引用指针。唯一可控出口就是 String() 方法。
String() 方法签名和接收者类型必须严格匹配调用场景
如果你传的是 *MyStruct 给 fmt.Println，但只实现了 func (m MyStruct) String() string，那 String() 根本不会被调用 —— Go 不会自动解引用或转换接收者类型。
实操建议：
- 统一用指针接收者：
func (s *MyStruct) String() string，覆盖MyStruct和*MyStruct两种传入方式（因为fmt对值类型也会取地址调用） - 务必在方法开头判空：
if s == nil { return "<nil>" }</nil>，否则fmt.Println((*MyStruct)(nil))会 panic - 避免在
String()中修改结构体字段或触发副作用 —— 它只应做纯格式化 - 不要试图在
String()里调用json.Marshal或其他重量级操作，性能敏感路径下会被高频调用
如何安全展示指针字段的实际值（而非地址）
核心是手动解引用 + 空值保护。例如结构体含 *string 字段，直接 *s.Name 会 panic 如果 s.Name == nil。
示例代码片段：
type Config struct {
Timeout *int
Host *string
}
func (c *Config) String() string {
if c == nil {
return "<nil config>"
}
timeout := "<nil>"
if c.Timeout != nil {
timeout = fmt.Sprintf("%d", *c.Timeout)
}
host := "<nil>"
if c.Host != nil {
host = fmt.Sprintf("%q", *c.Host)
}
return fmt.Sprintf("Config{Timeout:%s, Host:%s}", timeout, host)
}</nil></nil></nil>
关键点：
- 每个指针字段都要单独判空，再决定解引用还是显示
<nil></nil> - 用
fmt.Sprintf("%q", ...)包裹字符串，避免空格/换行干扰日志解析 - 避免拼接大量字段时用
+，优先用fmt.Sprintf保证可读性和逃逸控制 - 如果字段是
map或slice，不要直接打印整个结构（可能无限递归），限制长度或只打 len/cap
String() 不生效？检查这三处硬性约束
最常踩的坑不是逻辑写错，而是编译器根本没把你的方法当 Stringer 看。
必须同时满足：
- 方法名严格是
String（首字母大写），返回类型严格是string - 接收者类型与实际传入值类型一致：传
*T就得定义在*T上，传T就得定义在T上 - 方法必须在同一个包内定义（跨包无法实现接口，除非导出且对方显式赋值）
特别注意：fmt.Printf("%s", v) 永远不会触发 String() —— %s 要求参数本身就是 string 类型，而 v 是结构体，类型不匹配直接编译失败。只有 %v、%+v、%#v、fmt.Println 这类泛型格式动词才会查 Stringer 接口。
真正容易被忽略的点是：String() 只影响 fmt 包的默认打印行为，对 json.Marshal、encoding/gob、甚至 log.Printf("%+v", v) 都无效 —— 后者仍走反射，显示所有字段。调试时别误以为“写了 String() 就万事大吉”，该加断点还得加，该打 pprof 还得打。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
