Symfony Maker Bundle 是零基础运行 Symfony 的刚性依赖，未安装或漏掉--dev参数会导致make:*命令报错退出；装后须执行php bin/console list make验证，并确保实体类路径、命名空间及doctrine.yaml配置符合约定。
Maker Bundle 不是“锦上添花”的玩具，它是零基础跑通 Symfony 的刚性依赖——没它，make:controller、make:entity 全部报错退出；装错位置（比如漏掉 --dev），后续部署时可能因自动加载开销触发 500。
为什么 make:* 命令一执行就报 command not found
这不是环境问题，而是 Maker Bundle 根本没装进项目。Symfony CLI 创建的项目默认不带 Maker Bundle，哪怕用了 --webapp 也不包含它。
- 必须手动运行
composer require --dev symfony/maker-bundle，--dev不能省——生产环境不需要代码生成器，写进主依赖会污染 autoloader - 装完后别急着跑命令，先执行
php bin/console list make确认输出里有make:controller、make:entity等条目 - 如果仍提示 command not found，检查
vendor/bin是否在 PATH 中，或直接用php bin/console make:controller绕过 shell 查找
make:entity 生成失败的三个典型卡点
交互式建实体看着简单，但字段类型、关系配置、空值约束三处选错，会导致迁移文件为空、数据库表缺失，甚至 make:crud 直接崩溃。
- 字段类型输
datetime而不是datetime_immutable：PHP 8.2+ 推荐后者，前者在 Doctrine 3.x 中已被标记为弃用，生成的 getter/setter 可能报类型错误 - 建关联时跳过“反向关系”却没手动补
inversedBy：比如Product→Category是 ManyToOne，那Category实体里必须显式加@ORM\OneToMany(mappedBy="category")，否则 Doctrine 查询时找不到反向映射 - 字段设为 “not null” 但没给默认值，又没在 PHP 层加
@Assert\NotBlank：数据库迁移能过，但表单提交空值时会抛出 SQL 级错误，而不是友好的验证提示
make:crud 生成后打不开页面？先看这三件事
CRUD 命令生成的是骨架，不是开箱即用的后台。最常被忽略的是权限、模板路径和路由冲突。
- 生成的控制器方法默认带
#[IsGranted("ROLE_ADMIN")]，但项目没配 Security Bundle 时，访问直接 500 —— 临时解决：删掉注解，或运行composer require symfony/security-bundle再按提示初始化 - 用
--template-path=templates/admin时，该目录必须真实存在，且路径区分大小写；Windows 下templates\Admin和templates\admin在某些配置下会被视为不同路径 - 如果已存在同名路由（比如手动写过
/product），make:crud不会覆盖或报错，而是静默跳过，最终访问 404 —— 运行php bin/console debug:router检查路由是否注册成功
迁移命令总提示 “No changes detected”，但数据库明明是空的
这不是命令失效，而是 Doctrine 没扫描到你的实体类。常见于新实体放在非标准目录，或 YAML 配置没生效。
- 确认实体类在
src/Entity/下，且命名空间是App\Entity（或你项目实际的根命名空间） - 检查
config/packages/doctrine.yaml中doctrine.orm.mappings.App.type: attribute是否启用，PHP 8.1+ 属性映射必须设为attribute，设成annotation会完全忽略#[Entity] - 运行
php bin/console debug:config doctrine，看输出里entity_managers.default.mappings是否列出你的实体路径；如果为空，说明配置未加载，可能是 YAML 缩进错误或文件名拼错（比如写成doctrine.yml而非doctrine.yaml）
Maker Bundle 的自动化程度很高，但它的“智能”全建立在约定之上：目录结构、命名空间、配置键名，错一个就断链。与其反复试错，不如先用 php bin/console debug:container 和 debug:router 看清楚当前系统到底识别了什么。
