Bundle包必须声明为type: symfony-bundle，否则Symfony Flex无法自动启用；需继承Bundle类、空构造、用build()注册扩展；运行时依赖写require，开发依赖写require-dev；推荐提交Flex recipe以实现自动配置。
Bundle包必须声明为type: symfony-bundle
Composer不识别“Bundle”这个概念，它只认type字段。如果你漏写或写成library，symfony/flex不会自动启用该包的bundle类，bin/console debug:bundle也查不到——哪怕类文件存在、命名规范、已注册到config/bundles.php里。
正确做法是在composer.json根级写明：
{
"type": "symfony-bundle",
"autoload": {
"psr-4": {
"Acme\DemoBundle\": "src/"
}
}
}
-
type必须是symfony-bundle（不是symfony-bundle-plugin等不存在的值） - Autoload路径要覆盖Bundle类（如
AcmeDemoBundleAcmeDemoBundle）和所有依赖类 - 不要在
require里硬加symfony/framework-bundle：Bundle本身不运行，应由宿主应用提供
Bundle类必须实现BundleInterface且不能有构造参数
Symfony在容器编译阶段实例化Bundle类，此时服务尚未构建完成。若Bundle构造函数要求LoggerInterface或ContainerInterface，会直接抛出RuntimeException：“You cannot create a service of type ‘…’ because the container is not fully built.”
正确写法是空构造 + build()方法注册扩展：
namespace AcmeDemoBundle;
use SymfonyComponentHttpKernelBundleBundle;
class AcmeDemoBundle extends Bundle
{
}
- 继承
SymfonyComponentHttpKernelBundleBundle即可，它已实现BundleInterface - 禁止在
__construct()中注入任何服务；需延迟到build()或DependencyInjection扩展中处理 - Bundle类名必须与命名空间严格匹配（如
AcmeDemoBundleAcmeDemoBundle），否则Flex无法自动发现
依赖管理：运行时依赖 vs 开发依赖要分清
用户安装你的Bundle时，Composer会把require里的包全拉下来。如果误把phpunit、symfony/maker-bundle写进require，会导致用户项目无故引入开发工具，甚至引发版本冲突。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
区分方式非常明确：
- 运行时必需的：写进
require，例如symfony/config、symfony/dependency-injection（只要Bundle自己用到了这些组件的API） - 仅用于测试或生成代码的：写进
require-dev，例如phpunit/phpunit、symfony/phpunit-bridge - 若Bundle支持多个Symfony主版本（如5.4/6.4/7.x），用
^5.4 || ^6.4 || ^7.0而非^5.0，避免用户升级主框架后Bundle被Composer锁死
flex配置文件recipes不是必须的，但没它就等于没发布
你执行composer require acme/demo-bundle能装上代码，但不会自动创建config/packages/acme_demo.yaml、不会注册AcmeDemoBundle到bundles.php——除非你提交了Flex recipe到symfony/recipes-contrib仓库。
recipe本质是一组模板文件，放在symfony/recipes-contrib/acme/demo-bundle/1.0下，含：
-
manifest.json：声明适用的Symfony版本范围、是否启用、是否需要交互 -
config/packages/acme_demo.yaml：默认配置 -
src/DependencyInjection/Configuration.php（可选）：若Bundle支持配置树
没recipe的Bundle，用户得手动改bundles.php、手写配置、自己注册命令和服务——没人会这么用。
Flex recipe审核较慢，建议先用"extra": {"symfony": {"allow-contrib": true}}在composer.json中开启contrib recipes支持，再本地测试安装流程。
