Composer Flex 通过预定义 recipe 在 composer require/remove 时生成或修改配置，不解析代码、不运行时干预；recipe 从官方仓库匹配安装，支持智能合并但不自动更新旧配置。
Composer Flex 不是“自动配置”，而是通过预定义的“recipe”在安装/卸载包时触发配置文件生成与修改。 它本身不解析你的代码逻辑，也不运行时干预，只在 composer require 或 composer remove 阶段介入。
Flex 如何识别并应用 recipe
当你执行 composer require symfony/webpack-encore-bundle，Flex 会：
- 查 symfony/recipes 仓库（或本地
symfony/recipes-contrib），按包名 + 版本范围匹配对应 recipe - recipe 是一个包含
manifest.json和若干模板文件（如config/packages/webpack_encore.yaml）的 Git 仓库子目录 - Flex 根据
manifest.json中的copy-from、copy-to、files等指令，把模板内容写入项目对应路径 - 如果目标文件已存在（如
config/bundles.php），Flex 会尝试智能合并——不是覆盖，而是追加或去重
为什么有些包没触发 Flex？
常见原因有三个：
- 该包未在
symfony/recipes或symfony/recipes-contrib中注册 recipe（比如私有包或新发布包） - 你禁用了 Flex：
composer config extra.symfony.allow-contrib false，或全局设置了allow-plugins.composer/package-versions-deprecated false（旧 Flex 版本依赖它） - 当前项目不是 Symfony Flex 初始化的项目：缺少
symfony/flex作为require-dev，或composer.json中没有"type": "project"
如何调试 recipe 是否生效
运行命令时加 -v 查看详细日志：
composer require doctrine/doctrine-bundle -v
你会看到类似输出：
[Symfony\Flex\Recipe] Installing doctrine/doctrine-bundle (2.10.0)
若没这行，说明 Flex 没接管。也可手动检查：
- 运行
composer show symfony/flex确认已安装 - 查看
composer.json中是否有"extra": {"symfony": {"allow-contrib": true}} - 执行
composer recipes列出所有已安装 recipe 及状态（inst/sync/miss）
recipe 合并逻辑容易踩的坑
Flex 对 config/bundles.php 和 config/routes.yaml 做的是“语义化插入”，但有边界：
- 它只识别标准格式：例如
MyBundle::class => ['all' => true]这种键值对，若你在该文件里写了注释块或条件判断，Flex 可能跳过或报错 - 多个 recipe 同时写同一个文件（如都改
config/packages/framework.yaml）时，Flex 不做冲突解决，后安装的会覆盖前一个——除非 recipe 显式声明"merge": "append"或使用placeholders -
composer update默认不会重新运行 recipe；只有composer update --with-dependencies或显式composer recipes:install vendor/package --force才会重装
真正要留意的是：recipe 是静态快照，不是活配置。一旦生成，后续框架升级或 Bundle 行为变更，Flex 不会自动更新你的配置文件——得靠人去看 changelog，再手动调整。
