创建 Symfony Bundle 需满足三重条件：Bundle 类必须继承 SymfonyComponentHttpKernelBundleBundle，类名以 Bundle 结尾且文件名严格匹配；composer.json 必须声明 "type": "symfony-bundle" 和正确 PSR-4 autoload；最后需注册到 config/bundles.php 或依赖自动发现机制。
创建 Symfony Bundle 不是简单建个文件夹，而是要满足框架识别、自动加载、配置集成三重条件。核心在于结构合规、命名准确、注册明确。
Bundle 类必须继承 Bundle 且命名规范
Bundle 的入口类必须直接继承 SymfonyComponentHttpKernelBundleBundle，不能遗漏或写错命名空间。常见错误包括：
- 类名不以 Bundle 结尾（如写成
AcmeDemo而非AcmeDemoBundle） - 文件名与类名不严格一致（
AcmeDemoBundle.php里写了class AcmeDemoBundle才有效） - 命名空间路径和
composer.json中的 PSR-4 映射不匹配（例如类是MyCompanyMyBundleMyBundle，autoload 就得写"MyCompany\MyBundle\": "src/"）
用命令快速生成骨架结构
推荐使用 Maker Bundle 自动生成标准目录，省去手动搭建风险：
- 运行
php bin/console make:bundle AcmeDemoBundle - 它会创建完整结构：
src/Acme/DemoBundle/下含AcmeDemoBundle.php、DependencyInjection/、Resources/config/等 - 生成的
AcmeDemoExtension已预置load()和getConfiguration()方法，可直接扩展服务
composer.json 必须声明 type 和 autoload
想让 Bundle 可被其他项目通过 Composer 安装并自动启用，这两项不可省略：
-
"type": "symfony-bundle"—— Symfony Flex 依赖该字段触发自动注册和 recipe 安装 -
"autoload": { "psr-4": { "Acme\DemoBundle\": "src/" } }—— 确保 Bundle 类及所有子类（如命令、监听器、配置类）都能被正确加载 - 本地开发时可用
composer config repositories.acmedemo path ./acme-demo-bundle+composer require acme/demo-bundle:dev-main模拟真实安装流程
注册到内核才算真正生效
Bundle 类写好了、autoload 配好了，还差最后一步：
- Symfony 4.4+ 默认支持自动发现，前提是类在
src/下且命名空间与 autoload 匹配 - 若未自动注册，检查
config/bundles.php是否包含：AcmeDemoBundleAcmeDemoBundle::class => ['all' => true], - 验证是否成功：运行
php bin/console debug:bundle | grep Acme，有输出即表示已识别
