YamlDotNet是C#生态中唯一稳定支持多文档、锚点、类型转换和精准错误定位的YAML库；安装执行dotnet add package YamlDotNet，反序列化须用new DeserializerBuilder().Build()并显式配置命名约定、类型转换器及UTF-8编码处理。
直接用 YamlDotNet，别绕弯——它不是“能用”，而是当前 C# 生态里唯一能稳住多文档、锚点、类型转换和错误定位的方案。
安装和基础反序列化怎么写才不崩
装错包是第一个坑：执行 dotnet add package YamlDotNet，别加 YamlDotNet.Serialization 单独子包（它已包含在主包中）。装完后，最简反序列化代码必须显式构造 IDeserializer 实例，不能只靠默认构造器。
- 必须用
new DeserializerBuilder().Build()创建实例，否则大小写、命名约定、类型转换全按默认规则走，极易失败 - YAML 键是
api_url，C# 属性名是ApiUrl？得配UnderscoredNamingConvention.Instance，或者更稳妥地给属性加[YamlMember(Alias = "api_url")] - 所有目标类属性必须是
public且含 getter/setter；字段（public string Host;）不会被识别 - 若 YAML 含中文值或键，确保文件保存为 UTF-8 无 BOM 格式，否则
File.ReadAllText(path)可能读出乱码或不可见控制符
嵌套结构映射失败的常见原因
报 YamlException: (Line: X, Col: Y) Exception during deserialization，八成不是语法错，而是类型或路径断了。YamlDotNet 不会自动跳过缺失字段，也不会把 timeout: 30s 猜成 TimeSpan。
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 检查每一层 class 是否 public、是否带完整 getter/setter；
ServerConfig嵌在Config里，但Config.server属性没 setter → 直接 null 引用 - YAML 中写
enabled: yes或on，bool Enabled会解析失败——默认只认true/false；需注册BooleanConverter或统一改用true/false - 日期字段如
created: 2023-10-05默认当字符串；要转DateTime，得在DeserializerBuilder中加.WithTypeConverter(new TimestampConverter()) - 数字带单位（
timeout: 30s）必须自定义IYamlTypeConverter，别指望内置逻辑
怎么安全读取多文档 YAML（--- 分隔）
Deserialize<T>(yaml) 永远只取第一个文档。Kubernetes 风格配置、CI 模板、多环境合并场景下，必须手动遍历解析器。
- 用
var parser = new Parser(new StringReader(yamlContent))初始化，别传整个字符串给Deserialize - 循环调用
parser.MoveNext()，每次进if (parser.Current is DocumentStart)后再调deserializer.Deserialize<T>(parser) - 别试
Deserialize<IEnumerable<T>>—— 它不会拆文档，只会把第一个文档当集合首项，其余全丢 - 每个文档独立反序列化，类型可不同；适合混合配置（如前段是全局设置，后段是服务列表）
为什么捕获 YamlException 还是看不出哪行错了
异常对象本身有线索，但容易被忽略：e.Start.Line 和 e.Start.Column 是真实位置，而 e.Message 有时只说“无法反序列化”，没提字段名。
- 打印原始 YAML 字符串时，用
Console.WriteLine($"Line {e.Start.Line}: {yamlLines[e.Start.Line - 1]}")快速定位上下文 - 缩进混用空格与 Tab、键后缺空格（
host:localhost）、注释出现在 map value 后面，都会触发YamlException，但错误位置可能偏移 - VS Code 装 YAML 插件并开启
"yaml.format.enable": true，实时标红比运行时报错快十倍 - 别依赖
ignoreUnmatched开关来绕过字段缺失——它掩盖问题，不解决映射断裂
真正麻烦的从来不是“怎么读出来”，而是“怎么让下次改 YAML 时不翻车”：命名约定要统一、类型边界要显式声明、多文档要主动迭代、错误信息要连带上下文打出来——这些细节漏掉任意一个，都会让配置变成线上事故的引信。
