Go 中自定义枚举类型实现了 Stringer 接口后，单独打印能显示字符串，但作为结构体未导出字段时，%v 等格式化动词会忽略 String() 方法而输出数值；解决方法是将该字段改为首字母大写的导出字段。
go 中自定义枚举类型实现了 `stringer` 接口后，单独打印能显示字符串，但作为结构体**未导出字段**时，`%v` 等格式化动词会忽略 `string()` 方法而输出数值；解决方法是将该字段改为**首字母大写的导出字段**。
在 Go 语言中，fmt 包对结构体字段的格式化行为严格遵循导出性（exported）规则：只有首字母大写的导出字段，其值在使用 %v、%+v 或 %#v 等动词打印时，才会触发其底层类型的 String() 方法（如果实现了 fmt.Stringer 接口）；而小写开头的未导出字段，则始终以默认方式（如整数、布尔等基础表示）输出，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 // ❌ 未导出字段 → 忽略 String()，直接打印数值
}
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 始终用字面值，不调用 String()）
}关键点说明：
-
fmt.Printf("%v", s)和fmt.Printf("%+v", s)对导出字段会调用String()方法（因此Field1显示为"Foo"），但对未导出字段（field2）仍按int值打印（即2）； -
fmt.Printf("%#v", s)是调试专用格式，永远不调用String()，它只展示 Go 语法级别的字面表示（如Field1:1），无论字段是否导出； - 若需所有字段统一显示字符串形式，除确保字段导出外，还可为结构体自身实现
String()方法，显式控制整体输出逻辑：
func (s MyStruct) String() string {
return fmt.Sprintf("MyStruct{Field1:%s, field2:%s}", s.Field1, MyEnum(s.field2))
}⚠️ 注意事项：
- 字段导出不仅影响
fmt行为，也影响包外可访问性，请根据设计意图权衡封装性； -
String()方法应保证无副作用、线程安全、返回稳定结果，避免 panic 或依赖外部状态； - 若结构体嵌套多层且需深度字符串化，建议优先使用导出字段 + 组合
Stringer，而非过度依赖fmt的自动行为。
综上，让枚举字段在结构体中正确显示字符串的本质，是遵守 Go 的导出规则——只有导出字段才能参与接口方法的动态分发。这是 Go 类型系统与格式化机制协同工作的设计体现，而非 bug。
