必须用try/catch捕获yaml::exception，否则yaml::loadfile()失败会直接terminate；as()对未定义或类型不匹配节点返回零值而非抛异常，需用isdefined()和默认值保障安全。
加载文件前必须捕获 YAML::Exception
不包 try/catch 就调 YAML::LoadFile()，程序会直接 abort，不是崩溃在你的代码里，而是 terminate 在 yaml-cpp 内部。错误信息通常只显示 YAML::ParserException 或 YAML::BadConversion，但不会告诉你哪行出问题。
- 始终用
try { auto config = YAML::LoadFile("config.yaml"); } catch (const YAML::Exception& e) { std::cerr - 路径是相对路径时，
std::filesystem::current_path()打印出来确认当前工作目录 —— 它和可执行文件所在目录常常不一致 - Windows 下用
std::ifstream读原始内容时，记得加.imbue(std::locale::classic())，否则换行或中文可能错位，影响后续Mark()行号定位
访问嵌套字段不能链式调用 ["a"]["b"]["c"].as<int>()</int>
这种写法在任意一级缺失（比如 config["database"] 不存在）时，会静默返回空节点，再取 ["connections"] 还是空节点，最后 .as<int>()</int> 返回 0 而非报错 —— 逻辑就悄悄错了。
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 逐级检查存在性：
if (config["database"] && config["database"]["connections"] && config["database"]["connections"].size() > 0) -
empty()比size() == 0更安全：对未定义的 node，size()返回 0，但empty()明确判别是否为合法 Sequence - 数组索引前必须校验长度：
if (config["servers"].size() > i) { auto host = config["servers"][i]["host"].as<:string>(); }</:string>
as<t>()</t> 返回零值不是 bug，是设计行为
node["timeout"].as<int>()</int> 在字段缺失或类型不匹配（比如值是 "30s" 字符串）时，返回 int{} 即 0；as<:string>()</:string> 返回空串。它不抛异常，也不提示，这是 yaml-cpp 的明确语义。
- 安全写法是带默认值：
int timeout = config["timeout"].as<int>(5000);</int> - 若需区分“没配置”和“配了但非法”，先用
IsDefined()+IsScalar()判类型，再调as<t>()</t> - 布尔字段尤其危险：
"false"字符串不会自动转成false，得手动处理或用as<bool>(false)</bool>配合类型检查
Node 是引用语义，别传引用、别返局部子节点
所有 YAML::Node 对象都指向内部解析树的某个位置，生命周期绑定于最原始的 YAML::Node（比如 YAML::LoadFile() 返回的那个）。一旦原始对象析构，所有子节点引用都悬空。
- 禁止写
return doc["config"];——doc出作用域后，返回的 Node 就失效 - 需要持久化字段值，就复制内容：
std::string host = node["host"].as<:string>();</:string> - 大配置文件解析完不用时，建议用局部作用域包裹，或显式调
node.reset();释放内存
YAML::ParserException 直接炸在第一行，调试时得先开十六进制编辑器看文件头和空白符。
