Maker Bundle 仅在明确目标时提效，安装须加 --dev 参数，make:entity 需配合 make:migration 使用并手动处理索引与编码限制，make:command 需改构造函数、命令名和输出方式，make:crud 不处理软删除、权限与事务，需人工补全。
Maker Bundle 不是魔法，它只在你清楚要建什么时才真正省时间——比如加个新控制器、补个实体类、写个命令脚手架。它不替你决定字段要不要唯一、关系要不要级联删除、控制器要不要权限校验。
安装必须带 --dev 参数
运行 composer require --dev symfony/maker-bundle 是唯一安全的安装方式。漏掉 --dev 会让 Maker 进入生产依赖列表，部署时 Composer 可能加载它触发 autoloader 扫描，拖慢请求启动速度。Symfony 7.2 默认启用自动发现，但前提是包装在 require-dev 下；否则 php bin/console list make 直接报错“command not found”。
make:entity 生成后不能跳过 make:migration
执行 php bin/console make:entity Product 只写 PHP 类，不碰数据库。常见错误是直接跑 doctrine:schema:update --force，结果 MySQL 报错 Specified key was too long：因为默认 string 字段 length=255，在 utf8mb4 编码下超索引长度限制。正确路径是：
- 先运行
php bin/console make:migration生成迁移文件（它会读取实体变更） - 手动检查生成的
src/Migrations/*_create_product_table.php，必要时改$this->addSql('CREATE TABLE product (..., name VARCHAR(191) NOT NULL)') - 再执行
php bin/console doctrine:migrations:migrate
注意：make:entity 不加 @ORM\Index，哪怕你写了 user_id 字段，也得自己补索引或在迁移里加 $this->addSql('CREATE INDEX IDX_PRODUCT_USER_ID ON product (user_id)')。
make:command 生成后要立刻改三处
php bin/console make:command app:backup-users 生成的类只是骨架。真实可用前必须动这三处：
- 构造函数加类型提示注入服务，例如
private UserRepository $userRepository;+public function __construct(UserRepository $userRepository)，否则$this->getContainer()->get()在 Symfony 6+ 已弃用 -
configure()里调用$this->setName('app:backup:users')—— Maker 默认用短横线，冒号分隔需手动设 -
execute()方法里用$output->writeln()输出日志，别用echo；返回值必须是int，成功返回Command::SUCCESS（即 0），失败返回非零整数
make:crud 依赖 Doctrine 配置且不处理软删除
php bin/console make:crud Product 会生成控制器、模板、表单类和路由注解，但它假设你用的是标准 Doctrine ORM 流程。容易踩的坑有：
- 没配好
doctrine.yaml（比如url错、server_version漏）会导致命令卡住或生成空模板 - 生成的
index.html.twig用productRepository->findAll()，如果实体启用了软删除（@SoftDeleteable），它不会自动过滤已删除记录，得手动改查询方法 - 表单类默认绑定全部字段，含
createdAt这类只读字段，提交时会报验证错误，得删掉或加['disabled' => true]
最常被忽略的点：生成的 CRUD 控制器方法里没有事务控制、无批量操作保护、不校验用户权限——这些都得你手写补上，Maker 不越界。
