os.ReadFile读配置文件总panic是因为未检查error就直接使用返回值，或文件不存在时无兜底；正确做法是先判断err!=nil，再处理内容，避免优雅panic，生产环境应返回明确错误或fallback默认配置。
os.ReadFile 读配置文件时为什么总 panic？
因为没检查错误就直接用返回值，或文件根本不存在却没兜底。Go 不会自动创建配置文件，os.ReadFile 遇到路径不存在、权限不足、格式非法等情况都会返回非 nil 的 err，直接 panic 或忽略会导致程序崩溃或静默失败。
- 永远先判断
err != nil，再处理内容；不要写成if err := ...; err != nil { panic(err) }这类“优雅 panic”——生产环境应返回明确错误或 fallback 默认配置 - 用
os.Stat提前探路：如果os.Stat("config.yaml")返回os.IsNotExist(err)，说明文件缺失，此时可初始化默认结构体，而不是硬报错 - YAML/JSON/TOML 解码失败时，错误类型不同：
yaml: line 5: did not find expected key是语法问题；json: cannot unmarshal string into Go struct field Config.Port of type int是类型不匹配——别笼统打印 “配置解析失败”，要透出原始 error 信息
修改配置后怎么避免写坏文件？
直接 os.WriteFile 覆盖有风险：写入中途崩溃，原配置就丢了。必须用原子写入，核心是“写临时文件 + 原子重命名”。
- 生成临时文件路径用
os.CreateTemp("", "config-*.yaml")，而非拼接字符串（避免竞态和路径注入） - 写完调用
os.Rename(tmpPath, realPath)—— Linux/macOS 下是原子操作；Windows 上需额外处理：先os.RemoveAll(realPath)再os.Rename，否则会报invalid cross-device link - 写入前建议做一次格式校验：比如 YAML 用
yaml.Unmarshal再yaml.Marshal回去，看是否能 round-trip；失败则立刻返回错误，不落地 - 可选加备份：写入前
os.Rename(realPath, realPath+".bak")，但要注意.bak文件累积问题，生产环境慎用
结构体 tag 怎么写才兼容多格式？
一个结构体要同时支持 YAML/JSON/TOML，tag 必须显式对齐字段名，且不能只写一种格式——否则换格式库就失效。
- 字段级 tag 示例：
Host string `yaml:"host" json:"host" toml:"host"`，三个 key 保持一致；嵌套结构同理，外层结构体也要带 tag：Server ServerConfig `yaml:"server" json:"server" toml:"server"` - 别依赖默认映射规则：比如 JSON 默认转驼峰，但 YAML 不转——必须显式声明，否则
timeout_ms在 JSON 里可能是timeoutMs，在 YAML 里还是timeout_ms，导致行为不一致 - 敏感字段如
Password建议设为string `yaml:"-" json:"-" toml:"-"`，强制从环境变量或 secret store 注入，不在配置文件中出现
测试配置读写为什么总污染本地文件？
测试时硬编码 "config.yaml" 路径，跑完留下垃圾文件，或多个测试并发写同一路径导致冲突。
立即学习“go语言免费学习笔记（深入）”；
- 所有测试必须用
os.CreateTemp创建隔离临时文件，例如：tmpfile, _ := os.CreateTemp("", "test-*.yaml")，测试结束用defer os.Remove(tmpfile.Name()) - 把读写逻辑封装成函数或接口（如
Loader.Load(path string) (Config, error)），测试时传入临时路径，而非改全局变量或常量 - 避免在测试里调用
os.Exit或log.Fatal——它们会终止整个测试进程，导致后续测试不执行 - 表驱动测试覆盖多种场景：空文件、非法缩进 YAML、缺失必填字段、权限拒绝等，每种都走独立临时路径
~，不调用 os.UserHomeDir() 展开就会打开失败；或者程序以非 root 用户运行，却试图写入 /etc/ 下的文件，错误提示却是 “no such file or directory”，而非 “permission denied”。这些细节不提前验证，上线后第一件事就是挂配置。 
