Go配置解析需避免panic，应分类处理I/O、语法、类型错误，设置合理默认值，结合viper等库增强日志提示与校验。
Go 语言本身不内置配置文件解析器，常用方案是结合 encoding/json、gopkg.in/yaml.v3 或第三方库（如 spf13/viper）处理。关键在于：解析失败时不能 panic，而应明确区分错误类型、提供合理默认值，并给出清晰提示，便于排查和降级。
捕获并分类解析错误
不要直接忽略 err，而是判断错误来源：
- 文件不存在或权限不足：属于 I/O 错误，应提示路径问题，避免尝试解析
- 语法错误（如 YAML 缩进错、JSON 多余逗号）：属于格式错误，需指出具体行/列（部分库支持），方便用户修正
- 字段类型不匹配（如字符串赋给 int 字段）：属于结构体映射错误，可记录字段名并考虑容错转换
结构体字段设置有意义的默认值
利用 Go 的零值特性 + 显式初始化，让配置即使缺失也不导致 panic：
- 数值字段用
int、float64类型，默认为0；但更推荐用指针或自定义方法控制“是否显式设置” - 字符串字段设为空字符串
""，但业务上常需非空默认值（如Addr: "localhost:8080"） - 布尔字段慎用零值
false，建议显式声明：Debug: true或通过标签标记默认值（如 viper 支持viper.SetDefault("log.level", "info")）
用日志+上下文增强错误提示
仅打印 err.Error() 不够，应补充环境信息：
立即学习“go语言免费学习笔记（深入）”；
- 记录配置文件路径、被解析的结构体类型
- 对语法错误，调用
yaml.ParseError的ProblemMark或json.Unmarshal的位置信息（需包装） - 示例提示：
failed to parse config.yaml at line 12, column 5: cannot unmarshal string into Go struct field Server.Port of type int
推荐组合：viper + 自定义校验 + fallback 日志
viper 天然支持默认值、多格式、自动重载，配合简单封装即可兼顾健壮与提示：
- 调用
viper.SetConfigFile("config.yaml")前先os.Stat检查文件是否存在 - 用
viper.SetDefault("database.timeout", 30)设全局默认 - 解析后手动校验必要字段：
if viper.GetString("app.name") == "" { log.Fatal("app.name is required in config") } - 最终用
viper.Unmarshal(&cfg)，若失败则打印完整错误 + 当前已加载的配置键列表辅助定位
不复杂但容易忽略：默认值不是写死在代码里就万事大吉，它必须和文档一致、经测试覆盖、且在错误提示中可追溯。
