yaml.Unmarshal总返回空结构体，根本原因是结构体字段未导出（须首字母大写）或yaml标签与YAML键名不匹配（大小写、下划线等需严格一致），且必须传结构体指针、显式检查错误。
yaml.Unmarshal 为什么总返回空结构体？
根本不是库的问题，而是结构体字段没导出或标签对不上。Go 的 yaml.Unmarshal 只能设置首字母大写的字段（即已导出字段），且默认按字段名小写匹配 YAML 键——但这个自动转换不保险，尤其遇到下划线命名时会失效。
- 字段必须首字母大写，比如
Port，不能写成port - YAML 里是
redis_url，结构体字段就得配RedisUrl string `yaml:"redis_url"`；只写RedisUrl不加 tag，Unmarshal会去找redisurl，直接跳过 - 嵌套结构体里每一层的字段都得满足上述两点，漏一层就会整块为空
- 传参必须是指针：
yaml.Unmarshal(data, &cfg)，不是yaml.Unmarshal(data, cfg)
用 map[string]interface{} 还是结构体？
不是“哪个更好”，而是“哪段该用哪个”。固定字段用结构体，动态键值用 map[string]interface{}，混用才是常态。
- 结构体适合顶层配置：编译期校验、IDE 提示、字段复用（比如多个 service 共享
Timeout字段） -
map[string]interface{}适合插件参数、用户自定义字段（如extras: {log_level: debug, retry_times: 3}），但每次取值都要类型断言：v, ok := cfg.Extras["retry_times"].(int) - 推荐组合：结构体字段声明为
Extras map[string]interface{} `yaml:"extras"`，既保结构又留扩展性 - 性能差异可忽略，真正耗时在 YAML 文本解析本身，不在目标类型选择
os.ReadFile 和 embed.FS 在打包时怎么选？
本地跑通 ≠ 上线能用。二进制打包后 os.ReadFile 会报 “no such file”，因为文件没打进 binary；必须切到 embed.FS。
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 开发阶段用
os.ReadFile("config.yaml")没问题 - 发布前加
//go:embed config.yaml注释，声明变量：var f embed.FS - 读取时改用
fs.ReadFile(&f, "config.yaml")，路径是相对于//go:embed所在 .go 文件的相对路径 -
embed.FS不支持通配符或目录遍历，每个文件必须显式声明，别指望embed.FS自动加载子目录下所有*.yaml
动态遍历 YAML 节点时容易漏掉什么？
用 yaml.Node 递归解析看似灵活，但节点类型判断和路径拼接稍有疏忽，就会跳过某层或 panic。
立即学习“go语言免费学习笔记（深入）”；
-
yaml.Node.Kind必须逐个判断：yaml.DocumentNode、yaml.MappingNode、yaml.SequenceNode、yaml.ScalarNode，漏判MappingNode就进不了对象内部 - 数组项的路径拼接要用方括号，比如
db.servers[0].host，而不是点号连写 - 空值（
null）对应yaml.ScalarNode且Value == ""，不是nil，别用== nil判断是否存在 - 锚点与别名（
&anchor/*anchor）会被yaml.v3自动解引用，无需手动处理，但若需保留原始结构就得换goccy/go-yaml
最常被忽略的是：YAML 中的注释、锚点、多文档（--- 分隔）在 yaml.v3 默认模式下会被丢弃，要保留就得启用 yaml.Node 模式并手动遍历，不是加个 flag 就能解决的事。
