PHP用symfony/yaml读YAML配置必须检查三件事：文件无BOM/UTF-8签名、缩进全为空格、enabled: yes等需手动转布尔值，否则解析失败或类型错误。
Composer 是 PHP 的依赖管理工具，不是通用 YAML 解析方案。你提到的“用 Composer 安装 Yaml 组件”本身没错，但装完不等于能读配置——关键在怎么用、用哪个库、字段怎么映射、错误怎么排查。
PHP 用 symfony/yaml 读 YAML 配置必须检查三件事
symfony/yaml 是 PHP 生态最稳的 YAML 库（composer require symfony/yaml），但它默认不校验结构，也不自动绑定到对象，出错时只抛 ParseException，没上下文。
- YAML 文件开头不能有 BOM 或 UTF-8 带签名（否则报 “Unable to parse at line 1”）
- 缩进必须全用空格，混入 Tab 会直接失败（错误信息里通常不提 Tab，只说 “did not find expected key”）
- 如果 YAML 里写
enabled: yes，Yaml::parse()默认返回字符串"yes"，不是布尔值 —— 要开Yaml::PARSE_CUSTOM_TAGS或手动转换
Go 里 yaml.Unmarshal 返回空结构体？先看字段导出没
这是 Go 新手最高频的坑：yaml.Unmarshal 只能设置首字母大写的导出字段，小写字段如 port、timeout 会被静默忽略，不报错、不警告、值永远是零。
- 结构体定义必须是
Port int `yaml:"port"`，不是port int `yaml:"port"` - 嵌套结构体同理：内层字段也得大写，比如
DB struct { Host string `yaml:"host"` }→Host必须大写 - 传参必须是指针：
yaml.Unmarshal(data, &cfg)，传cfg值会 panic 或静默失败
Python 用 PyYAML 读配置，Loader 选错就中招
yaml.load() 在 PyYAML 5.1+ 已弃用，不指定 Loader 会警告；用 yaml.Loader 或 yaml.CLoader 则可能执行任意代码（反序列化漏洞）。
- 生产环境只用
yaml.safe_load()，它等价于yaml.load(..., Loader=yaml.SafeLoader) - 文件编码必须显式声明为
utf-8：with open("config.yaml", encoding="utf-8") as f:，否则中文字段读出来是乱码或UnicodeDecodeError - YAML 中的
null、~、NULL都解析为None，但如果你字段类型是int却没做空值判断，后续算术操作直接TypeError
OpenCV cv2.FileStorage 读 YAML 报 “Input file is invalid”？缺指令头
OpenCV 的 cv2.FileStorage 不兼容标准 YAML 文件，它要求文件第一行必须是 %YAML:1.0，否则无论内容多规范都报错。
- 哪怕只是普通键值对，也要加这一行：
%YAML:1.0\nhits: 5\ntime: 5000000 - 如果 YAML 里含
!!opencv-matrix这类标签，更不能用PyYAML读 —— 它不认识 OpenCV 自定义类型，会丢数据或 panic -
cv2.FileStorage只支持读，不支持写入后自动加该指令；生成配置时得脚本预处理或手动补上
真正容易被忽略的是：YAML 解析器之间不互通。同一个文件，symfony/yaml 能过，gopkg.in/yaml.v3 可能因缩进空格数不同而失败；cv2.FileStorage 要 %YAML:1.0，但其他所有库都把它当注释跳过。别假设“能被一个工具读，就能被另一个读”。
