ini.load()仅捕获节上方最近连续注释行，自动丢弃空行、前导空白及[section]行末内联注释；注释须紧贴节头无空行，否则section.comment为空或不全。
ini.Load() 为什么读不到节注释
因为 ini.Load() 默认只捕获「节上方最近一段连续的注释行」，且会自动丢弃空行、前导空白、以及 [section] 行末的 ; 或 # 内联注释。比如：
[db] ; 生产库配置 ; 注意超时设置 host = 127.0.0.1
这段里，Section.Comment 很可能只返回第一行；第二行和中间空行全丢失；而写成 [db] ; 生产库，分号后内容直接被忽略。
- 节前注释必须紧贴
[section]上方，中间不能插空行 - 避免在
[section]行末加;或#注释——它不属于该节 - 若需精确保留位置（如人工维护配置），别依赖
.Comment字段，改用ini.LoadSources()+ 自定义ini.LoadOptions，或换用 AST 级解析器
Key.Comment 为什么只截到分号就停了
Key.Comment 严格匹配键行末尾的 ; 或 # 后内容，不会解析值中自带的分号。例如：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
path = /tmp;log ; 存放日志
这里 Key.Comment 是 存放日志，但 path 的值会被截成 /tmp——除非你显式启用 IgnoreInlineComment: true，否则分号触发注释截断逻辑。
- 值中含
;或#必须用双引号包裹：path = "/tmp;log" - 设
IgnoreInlineComment: true可让整个;当作值一部分，但代价是Key.Comment永远为空 - 若需同时支持注释管理 + 值内分号，优先走引号包裹路线，而非关掉注释识别
binary.Read 解析二进制配置文件总读出零值
binary.Read 不能直接解析带字符串或变长字段的配置文件，它会 panic 或静默跳过未导出字段，读出来的值基本是零或乱码。必须拆解为“定长头 + 变长内容”两步处理。
- struct 所有字段名首字母必须大写（导出）
- 禁用
int/uint，改用int32、uint16等定长类型 - 字符串字段必须转成固定长度数组，例如
Name [64]byte；协议写“填充至 64 字节”，就得真填满 - 变长字段（如路径、描述）必须手动分步读取：先读长度字段（如
DescLen uint16），再分配缓冲区，再用io.ReadFull读满 - 立刻校验长度上限，复用预分配缓冲区，避免每次
make触发 GC
yaml.Unmarshal 读不出嵌套字段或 panic
别用 gopkg.in/yaml.v2 或已归档的 go-yaml/yaml（v1）。v2 对 map[string]interface{} 解析有严重 bug，会导致类型断言失败或 panic；Docker/Helm/K8s client-go 全已迁移到 v3。
- 安装命令必须是：
go get gopkg.in/yaml.v3（少写.v3或写成v3.0.0都会拉错版本） -
yaml:"timeout_ms,omitempty"中的omitempty只影响序列化输出，不影响反向解析 -
yaml:",inline"可把嵌套结构体字段拍平到当前层级，适合组合配置 - 多个 tag 可共存：
yaml:"log_level" envconfig:"log_level"，但别写成yaml:"log_level,envconfig"——这会被当做一个键名解析
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
