Symfony Flex 是 Composer 的配置大脑，通过 recipe 文件自动配置包、生成配置、设置环境变量并执行命令，且不覆盖已修改文件。
Symfony Flex 就是 Composer 的“配置大脑”——它不改代码，但会自动帮你写 config/packages/、注册 Bundle、生成 .env 变量、甚至跑 assets:install。你执行 composer require symfony/mailer，它就立刻给你配好 SMTP 配置骨架；不是“可能配”，而是“默认就配”。
Flex 怎么知道该配什么？看 recipe 文件
每个支持 Flex 的包（比如 symfony/mailer、doctrine/doctrine-bundle）在官方 symfony/recipes 仓库里都有一个对应版本的 JSON 配方，例如：symfony/mailer/6.4/manifest.json。这个文件声明了三件事：
- 要复制哪些模板文件（
copy-from是配方里的config/packages/mailer.yaml，copy-to是你项目里的config/packages/mailer.yaml） - 是否需要用户输入（比如问你
MAILER_DSN值，用questions字段定义） - 安装完要不要执行命令（如
"php bin/console assets:install"）
Flex 在 composer install 或 composer require 后，监听 post-package-install 事件，下载 ZIP、解压、按规则写入——不是覆盖，而是“跳过已存在且未修改的文件”，所以你改过的配置不会被暴力重写。
recipe 没生效？先查这三件事
常见现象：装了 symfony/notifier，但 config/packages/notifier.yaml 没出现，NotifierTransportFactory 也报类不存在。
- 确认
symfony/flex已安装：composer show symfony/flex—— 如果没装，composer require symfony/flex --dev - 检查 recipe 是否被禁用：
composer config extra.symfony.allow-contrib返回false？那社区包（contrib类型 recipe）全被拦住了，删掉这行或设为true - 看 recipe 状态：
composer recipes—— 出现 ⚠️ 表示文件冲突（你手动建过同名文件），❌ 表示没匹配到 recipe（包版本太新/太旧，或 recipe 还没收录）
想改默认配置？别直接删，用本地 recipe 覆盖
你不喜欢 symfony/mailer 默认生成的 config/packages/mailer.yaml？别手改完又怕下次更新被冲掉——Flex 支持优先级更高的本地 recipe：
- 在项目根目录建路径：
config/recipes/symfony/mailer/6.4/ - 放一个你自己的
manifest.json（内容可只写{"copy-from": ".", "copy-to": "."}） - 再放你要的
config/packages/mailer.yaml模板文件（支持%%APP_ENV%%这类占位符，Flex 会自动替换）
下次 composer update symfony/mailer，Flex 就会用你本地的版本，而不是从官网拉。注意：路径必须严格匹配包名+版本号，大小写和斜杠都不能错。
recipe 不是魔法，它是声明式配置的落地——你看到的每一份自动生成的 YAML，背后都是可审查、可提交、可回滚的 JSON 指令。最容易被忽略的是：Flex 不处理你已经手动创建的文件，哪怕它和 recipe 目标路径一模一样；它只管“首次安装”和“你没动过”的情况。所以别指望它帮你修烂摊子，它只负责把新车开出来。
