Go 语言中，可通过为自定义类型实现 String() string 方法，使其自动被 fmt.Print 等格式化函数调用，该机制由 fmt.Stringer 接口定义，是 Go 标准库内置的“约定式接口”。
go 语言中，可通过为自定义类型实现 `string() string` 方法，使其自动被 `fmt.print` 等格式化函数调用，该机制由 `fmt.stringer` 接口定义，是 go 标准库内置的“约定式接口”。
在 Go 中，fmt.Print、fmt.Println、fmt.Printf("%v") 等格式化输出函数并非依赖显式类型断言，而是通过运行时反射与接口检查自动识别并调用目标值的 String() 方法——前提是该值实现了 fmt.Stringer 接口：
type Stringer interface {
String() string
}只要你的结构体（或任何命名类型）实现了 String() string 方法，它就自动满足 Stringer 接口，fmt 包会在合适时机调用该方法，替代默认的结构体打印行为（如 {Field1:123 Field2:"abc"}）。
✅ 正确示例：
package main
import "fmt"
type Koala struct {
Name string
Age int
Sleep bool
}
// 实现 fmt.Stringer 接口
func (k Koala) String() string {
status := "awake"
if k.Sleep {
status = "sleeping"
}
return fmt.Sprintf("Koala{%s, %d years old, currently %s}", k.Name, k.Age, status)
}
func main() {
k := Koala{Name: "Blinky", Age: 4, Sleep: true}
fmt.Print(k) // 输出：Koala{Blinky, 4 years old, currently sleeping}
fmt.Printf("\n%v\n", k) // 同样触发 String()
fmt.Printf("%s\n", k) // 也适用（%s 显式要求字符串）
}⚠️ 注意事项：
- 方法必须是 值接收者 或 指针接收者，但需保持一致性：若结构体其他方法多用指针接收者，建议
String()也使用指针接收者（避免拷贝大对象），但注意fmt.Print(k)传值时仍可调用值接收者方法；而fmt.Print(&k)可同时触发两者。 -
String()方法内不应再调用fmt.Print/fmt.Sprintf等可能再次触发String()的操作，否则将导致无限递归（panic: runtime stack overflow）。 - 该机制仅对
fmt包的格式化函数生效（如Print,Printf,Sprint等），不改变 JSON 编码、Gob 序列化等其他标准库行为。 -
String()是“调试友好型”字符串表示，不应用于业务逻辑解析或持久化；如需序列化，请明确使用json.Marshal或自定义MarshalText等。
总结：String() string 是 Go 的“魔法方法”，无需导入额外包、无需注册，只需实现即生效。它是提升日志可读性、调试效率和 API 友好性的轻量级最佳实践。
