Composer recipes 在 Symfony 中需依赖已启用的 symfony/flex 插件，通过检查 composer show symfony/flex 输出及 composer.json 中 extra.symfony.allow-contrib 是否为 true 来确认支持；recipes 自动注入配置、文件并记录于 symfony.lock。
Composer 在 Symfony 中不只是装包工具，它通过 composer recipes 机制自动注入框架适配的配置、文件和脚本——但这个功能默认只在 Symfony Flex 项目中启用，且依赖 symfony/flex 插件是否已正确安装和启用。
怎么确认当前项目支持 recipes？
Flex 是 recipes 的运行基础。如果 composer show symfony/flex 报错或返回空，说明 Flex 未安装；若已安装但 recipes 不生效，大概率是 extra.symfony.allow-contrib 或 extra.symfony.require 配置缺失或冲突。
- 运行
composer show symfony/flex
，有输出即 Flex 已安装 - 检查
composer.json的extra段，必须包含："extra": { "symfony": { "allow-contrib": true, "require": "5.4.*" } } - 若
allow-contrib为false，第三方 bundle 的 recipe 将被跳过 - Flex 安装后会自动注册插件钩子，无需手动启用；但若之前用
--no-plugins装过包，需重新运行composer install
补全
recipes 安装时自动做了什么？
当执行 composer require symfony/webpack-encore-bundle，Flex 会查找该包在 symfony/recipes 或 symfony/recipes-contrib 中的 recipe，然后按规则复制文件、修改配置、执行脚本。
- 典型动作包括：向
config/packages/写入webpack_encore.yaml，向assets/添加app.js和app.css，追加package.json脚本 - recipe 版本与包版本强绑定（如
symfony/webpack-encore-bundle:1.15对应recipes/symfony/webpack-encore-bundle/1.15） - 所有操作记录在
symfony.lock，用于后续更新或回滚 - 若 recipe 含
copy-from-recipe字段，还会从 recipe 仓库拉取模板文件（如templates/bundles/TwigBundle/exception.html.twig）
如何查看、重装或跳过某个 recipe？
Flex 提供命令行接口直接干预 recipe 生命周期，不依赖手动删改文件。
- 列出已应用的 recipes：
composer recipes
- 查看某包 recipe 的状态（是否已安装、有无冲突）：
composer recipes symfony/mailer-bundle
- 强制重装（覆盖现有配置）：
composer recipes:install symfony/mailer-bundle --force -v
- 跳过安装 recipe（仅下载包，不写配置）：
composer require --no-scripts symfony/notifier-bundle
（--no-scripts会禁用 Flex 的 post-install 钩子） - 卸载 recipe 并还原文件（危险！会删 config 和 assets 下对应内容）：
composer recipes:uninstall symfony/form
recipe 冲突与手动修复常见场景
recipe 不是万能的，尤其当项目已有同名配置、自定义目录结构或使用了非标准环境变量时，容易触发冲突。
- 典型报错：
Conflict detected: config/packages/framework.yaml is not managed by any recipe—— 表示该文件存在但未被 recipe 初始化，后续同类 recipe 可能拒绝覆盖 -
解决方法：先运行
composer recipes:reinstall
，再手动比对symfony.lock中的 checksum 与当前文件内容是否一致 - 若想保留自定义配置又接受新 recipe，可把原文件重命名为
framework.yaml.dist，再让 recipe 生成新文件，最后手工合并 - 注意：recipe 不处理
.env文件的变量注入，APP_ENV或MESSENGER_TRANSPORT_DSN这类仍需手动添加
recipe 的核心价值在于减少重复劳动，但它不会替代你理解配置含义。一旦项目脱离标准结构（比如多 kernel、自定义 config 目录、Docker 化部署），就得随时准备手动接管 recipe 管理——毕竟 symfony.lock 里记的是哈希值，不是魔法。
