在 Go 中，若为自定义类型实现 String() string 方法但 fmt.Printf("%v", value) 未调用该方法，通常是因为方法接收者类型与实际传入值的类型不匹配——值类型变量无法调用指针接收者方法，这是 Go 方法集规则的核心体现。
在 go 中，若为自定义类型实现 `string() string` 方法但 `fmt.printf("%v", value)` 未调用该方法，通常是因为方法接收者类型与实际传入值的类型不匹配——值类型变量无法调用指针接收者方法，这是 go 方法集规则的核心体现。
Go 的 fmt 包在格式化输出（如 %v）时，会自动检测值是否实现了 fmt.Stringer 接口：
type Stringer interface {
String() string
}
但能否成功调用 String() 方法，取决于该方法是否属于当前值的方法集。而方法集由接收者类型严格决定：
- 类型 T 的方法集包含所有 值接收者（func (t T) Method()）声明的方法；
- 类型 *T 的方法集包含所有 值接收者 和 指针接收者（func (t *T) Method()）声明的方法；
- 而类型 T 的值 不能调用 *T 的指针接收者方法。
以 IPAddr 为例（假设为 [4]byte 类型）：
type IPAddr [4]byte
// ❌ 错误：指针接收者，但 fmt.Printf 传入的是值 ip（非 &ip）
func (ip *IPAddr) String() string {
return fmt.Sprintf("%d.%d.%d.%d", ip[0], ip[1], ip[2], ip[3])
}
func main() {
ip := IPAddr{127, 0, 0, 1}
fmt.Printf("%v\n", ip) // 输出: [127 0 0 1] —— 不调用 String()
}
此时 ip 是 IPAddr 类型的值，其方法集不包含 (*IPAddr).String，因此 fmt 忽略该方法，退而使用默认的数组格式化输出。
✅ 正确做法是使用值接收者，确保方法同时适用于 IPAddr 和 *IPAddr：
func (ip IPAddr) String() string {
return fmt.Sprintf("%d.%d.%d.%d", ip[0], ip[1], ip[2], ip[3])
}
func main() {
ip := IPAddr{127, 0, 0, 1}
fmt.Printf("%v\n", ip) // 输出: 127.0.0.1 ✅
fmt.Printf("%v\n", &ip) // 同样输出: 127.0.0.1 ✅（*IPAddr 方法集包含值接收者方法）
}
⚠️ 注意事项：
- 若类型包含大字段或需修改内部状态，才考虑指针接收者；但 String() 是只读操作，无理由使用指针接收者；
- fmt.Println、fmt.Printf("%v")、fmt.Sprint 等均依赖 Stringer 接口，行为一致；
- 编译器不会报错，但运行时静默降级——建议单元测试中显式验证 fmt.Sprintf("%v", x) 输出是否符合预期。
总结：实现 Stringer 时，优先选用值接收者，既简洁又兼容性最佳；仅当方法需修改 receiver 或类型过大时，再评估指针接收者，并确保调用方传入对应指针。这是 Go 方法集设计的关键实践准则。
