Go 中自定义枚举类型实现 Stringer 接口后，单独打印时能显示字符串，但作为结构体未导出字段时，%v 等格式化动词会忽略 String() 方法而输出原始数值；解决方法是将字段改为首字母大写的导出字段。
go 中自定义枚举类型实现 `stringer` 接口后，单独打印时能显示字符串，但作为结构体**未导出字段**时，`%v` 等格式化动词会忽略 `string()` 方法而输出原始数值；解决方法是将字段改为**首字母大写的导出字段**。
在 Go 语言中，fmt 包对结构体字段的格式化行为严格遵循导出性（exported）规则：只有首字母大写的导出字段，其值在使用 %v、%+v 等动词打印结构体时，才会触发该字段类型的 String() 方法（如果实现了 fmt.Stringer 接口）；而小写开头的未导出字段，则直接以底层类型字面量形式输出（如 int 值 1），完全绕过 String()。
以下是一个典型对比示例：
package main
import "fmt"
type MyEnum int
const (
Foo MyEnum = 1
Bar MyEnum = 2
)
func (e MyEnum) String() string {
switch e {
case Foo: return "Foo"
case Bar: return "Bar"
default: return fmt.Sprintf("%d", int(e))
}
}
type MyStruct struct {
Field1 MyEnum // ✅ 导出字段 → 触发 String()
field2 MyEnum // ❌ 未导出字段 → 直接打印数值
}
func main() {
s := &MyStruct{Field1: Foo, field2: Bar}
fmt.Printf("%v\n", s) // 输出：&{Foo 2}
fmt.Printf("%+v\n", s) // 输出：&{Field1:Foo field2:2}
fmt.Printf("%#v\n", s) // 输出：&main.MyStruct{Field1:1, field2:2}
}
值得注意的是：
-
%v和%+v在打印结构体时，对导出字段调用String()（故Field1显示"Foo"），但对未导出字段仍用默认格式（故field2显示2）； -
%#v（Go 语法格式）始终忽略String()方法，无论字段是否导出，一律输出底层值（Field1:1,field2:2），因为它旨在生成可复现的代码字面量，而非用户友好视图。
✅ 最佳实践建议：
- 若需结构体整体具备可读性输出，应确保相关字段为导出字段，并配合
String()方法； - 如必须保留未导出字段又希望统一美化输出，可为整个结构体实现
String()方法，手动控制格式； - 避免依赖
%#v展示业务语义——它专为调试/序列化设计，不尊重Stringer。
总之，Go 的格式化机制以“可见性”为前提：导出性是 Stringer 生效的先决条件。理解这一设计逻辑，是写出清晰、可维护 Go 打印逻辑的关键。
