用BurntSushi/toml读TOML最轻量稳定，但需满足字段首字母大写+类型严格匹配，否则静默失效；小写字段被跳过，类型不匹配则置零值，且无Encode功能。
用 github.com/BurntSushi/toml 读 TOML 配置最轻量、最稳，但必须严格满足导出字段 + 类型匹配两个前提，否则字段全为零值且不报错。
字段名小写？解析后永远是零值
Go 反射看不见小写字段，toml.DecodeFile 或 toml.Decode 会直接跳过它们，不报错也不警告。
- 错误写法：
port int→ 解析后port永远是0 - 正确写法：
Port int（首字母大写），再加 tag 显式对齐键名：Port int `toml:"port"` - 嵌套结构体同理：子字段也必须首字母大写，比如
Database struct{ Host string }中的Host - 如果 TOML 键含下划线（如
connection_max），必须用 tag：ConnectionMax int `toml:"connection_max"`
类型不匹配？静默丢弃，不是报错
TOML 和 Go 类型必须严格对应，否则该字段被忽略，值保持零值——这是最隐蔽的配置失效原因。
-
port = "8080"（字符串） vsPort int→ 字段被跳过，Port为0 -
enabled = "true"（字符串） vsEnabled bool→ 同样跳过，Enabled为false - 时间字段必须是
time.Time类型，且 TOML 中需为 ISO8601 格式（如2026-09-04T15:00:00Z），用string就原样存字符串 - 数组表
[[servers]]必须用切片接收：Servers []ServerConfig，用ServerConfig单实例或map会静默失败
读文件别用 DecodeFile，优先 os.ReadFile + Unmarshal
toml.DecodeFile 把“读取失败”和“解析失败”混在一起返回，掩盖问题根源；它也不处理 UTF-8 BOM（Windows 编辑器常带 \xef\xbb\xbf），导致解析报 invalid character 'ï' looking for beginning of value。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
立即学习“go语言免费学习笔记（深入）”；
- 推荐组合：
data, err := os.ReadFile("config.toml")→ 先检查文件是否存在、权限是否足够 - 再手动 strip BOM：
bytes.TrimPrefix(data, []byte("\xef\xbb\xbf")) - 最后调
_, err := toml.Decode(string(data), &cfg)，错误上下文清晰可分 - 单元测试也方便：直接传入不同
[]byte模拟各种配置场景
想写配置？BurntSushi/toml 不行，必须换库
github.com/BurntSushi/toml **没有 Encode 函数**，调用 toml.Encode 会报 undefined: toml.Encode。它只做单向解析，不支持生成或更新 TOML 文件。
- 要写配置，必须切换到
github.com/pelletier/go-toml/v2 - v2 的
toml.Marshal默认不缩进，需显式用toml.MarshalWithOptions(conf, toml.MarshalOpt{Indent: " "}) - v2 支持保留注释、inline table、位置信息等高级能力，但 API 与 BurntSushi 完全不兼容，struct tag 也不能混用
- 动态修改某一层级（比如只改
database.host）必须走 v2 的Document或TreeAPI，比 struct 绑定复杂得多
最易被忽略的是：字段小写 + 类型不匹配，这两个问题不会触发 panic 或 error，只会让配置“看起来加载成功”，实际关键字段全是零值——建议在解析后加简单校验，比如 if cfg.Port == 0 { log.Fatal("port not loaded") }。
