BurntSushi/toml是Go最稳、最轻量的只读TOML解析库，适合启动时一次性加载配置；它不搞抽象层、直接映射结构体，出错路径少、调试快，且错误提示清晰，而viper需手动设类型和环境变量配置，go-toml/v2读写兼容性差。
Go 原生不支持 TOML，必须用第三方库；github.com/BurntSushi/toml 是最稳、最轻量、错误提示最清晰的只读方案，适合启动时一次性加载配置。
为什么选 BurntSushi/toml 而不是 viper 或 go-toml/v2
它不搞抽象层，直接映射结构体，出错路径少、调试快。viper 默认不认 .toml 后缀，要手动 viper.SetConfigType("toml")，且环境变量覆盖需额外配 SetEnvKeyReplacer；pelletier/go-toml/v2 支持读写，但解析逻辑和 struct tag 行为与 BurntSushi 不兼容——如果你只要读配置、结构固定、不热重载，BurntSushi/toml 就是更直接的选择。
结构体字段必须首字母大写，否则解析静默失败
Go 反射无法访问小写字段，toml.DecodeFile 会跳过它们，不报错，但值永远是零值（0、空字符串、false）。
- 错误写法：
type Config { port int }→config.port永远是0 - 正确写法：
type Config { Port int }，对应 TOML 中的port = 8080 - 若 TOML 键是
PORT = 8080，则加 tag：Port int `toml:"PORT"` - 嵌套表如
[database]必须对应导出字段：Database DatabaseConfig `toml:"database"`，不能用匿名 struct 或小写字段
数组、表数组、时间字段类型必须严格匹配
TOML 和 Go 类型不一致时，DecodeFile 会跳过该键，不计入返回的键数，也不报错（除非开启严格模式）。
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
立即学习“go语言免费学习笔记（深入）”；
-
[[servers]]是表数组（array of tables），Go 中必须用切片：Servers []Server `toml:"servers"` -
[servers]（单个表）才对应单个 struct：Servers Server `toml:"servers"` - 多维数组如
hosts = [["a", "b"], ["c"]]→ 字段声明为[][]string，不是[]string - 时间字段（如
created = 2025-03-29T14:22:00Z）必须是time.Time类型，否则解析失败或 panic - TOML 写了
port = "8080"（字符串），但结构体定义Port int→ 解析失败，该键不计数
用 DecodeFile 返回值快速判断是否漏配
toml.DecodeFile("config.toml", &config) 返回两个值：(int, error)，第一个是成功解析的键数量。这个数字比单纯看 err == nil 更有信息量。
- 如果 TOML 有 12 个键，但返回 5，说明大部分字段没映射上
- 常见原因：结构体字段未导出、tag 写错、类型不兼容
- 建议在开发期加校验：
if n, err := toml.DecodeFile("config.toml", &config); err != nil || n == 0 { /* handle */ }
最易被忽略的是字段首字母大小写和类型严格性——它们不会触发 panic 或 error，而是让配置“看起来加载成功”，实际全是零值。别依赖运行时才发现问题，从第一次 DecodeFile 的返回键数就开始盯。
