phpEnv 下 YAML 扩展需手动配置：先确认 PHP 版本及线程安全模式，再下载匹配的 DLL 或编译源码，每个 PHP 版本须单独在 php.ini 中启用 extension，并注意切换版本后需重新配置；推荐用 symfony/yaml 组件替代以规避环境依赖。
phpEnv 下开启 YAML 扩展不能靠图形界面点一下就完事——它不提供 yaml 的一键安装选项，必须手动编译或替换 DLL，并确认 PHP 运行模式与扩展版本严格匹配。
phpEnv 中找不到 yaml 扩展怎么办
phpEnv 默认不集成 YAML 扩展，也没有「扩展管理」里勾选启用的入口。它只预装了常见扩展（如 opcache、mysqli），而 yaml 属于需手动介入的第三方扩展。
- 先用
php -v和php -i | findstr "Thread Safe"（Windows）或php -i | grep "Thread Safety"（Linux/macOS）确认 PHP 版本号和线程安全模型（TS/NTS） - 去 https://www.php.cn/link/cbb66d97b2fdb6ecee992eaa98ed9acf 找对应版本的 Windows DLL 或 Linux 源码包（例如 PHP 8.2 NTS x64 → 下载
php_yaml-2.2.3-8.2-nts-vs16-x64.zip） - Windows 用户：解压后把
php_yaml.dll放入 phpEnv 对应 PHP 版本的ext/目录（如D:\phpenv\versions\8.2.12\ext\），再把同压缩包里的yaml.dll放到该版本的根目录（如D:\phpenv\versions\8.2.12\） - Linux/macOS 用户：需先装
libyaml-dev（Ubuntu/Debian）或libyaml-devel（CentOS/RHEL），再用pecl install yaml编译，成功后检查extension=yaml.so是否写入了该版本的php.ini
phpEnv 切换 PHP 版本后 yaml 扩展失效
这是最常被忽略的问题：phpEnv 每个 PHP 版本有独立的 php.ini 和 ext/ 目录，你在 v8.1 开启了 yaml，切到 v8.2 后它默认没加载，也不会自动复制配置。
- 每次切换版本后，必须单独检查该版本的
php.ini是否含extension=php_yaml.dll（Windows）或extension=yaml.so（Linux/macOS） - 用
phpenv which php定位当前生效的 PHP 路径，再用php --ini确认加载的是哪个php.ini - 如果
php -m | findstr yaml（Windows）或php -m | grep yaml（Linux/macOS）无输出，说明扩展未加载，不是“装过了就行”，而是“每个版本都要单独配”
用 Symfony Yaml 组件替代扩展更省事？
是的，只要项目已用 Composer，symfony/yaml 是更稳妥的选择——它绕开了系统级扩展依赖，也不受 phpEnv 多版本切换影响。
立即学习“PHP免费学习笔记（深入）”；
- 执行
composer require symfony/yaml，确保项目根目录有vendor/autoload.php - 代码中必须显式引入 autoload：
require 'vendor/autoload.php';，漏这句会报Class 'Yaml' not found - 解析文件用
Yaml::parseFile(__DIR__ . '/config.yaml')，注意路径要真实存在且 PHP 有读权限 - 相比 PECL 扩展，
symfony/yaml解析速度略慢但兼容性极强，支持锚点、标签、多文档等高级语法，错误提示也更友好
真正麻烦的从来不是“怎么装”，而是装完发现只在一个 PHP 版本里有效，或者换环境就报错。phpEnv 的多版本隔离特性让 yaml 扩展成了「一次配置、处处检查」的事——别信「装一次全局生效」，每个版本都是独立世界。
