make:entity 默认不自动添加返回类型声明，因需 Symfony MakerBundle v1.40+ 且 PHP 8.0+ 才启用；关联方法缺失源于 inversedBy/mappedBy 配置错误或目标实体未创建；链式调用需手动将 setXxx() 返回类型改为 self 并加 return $this;。
make:entity 生成的 getter/setter 为什么没按字段类型自动加 return type？
因为 make:entity 默认不启用 PHP 7.4+ 的返回类型声明（return type），哪怕你的实体属性已用 string、int 等类型注解或 PHP 8 属性类型声明，它也不会自动把 public function getName() 补成 public function getName(): string。
这容易导致 IDE 提示“返回值未声明”、静态分析工具（如 PHPStan）报错，或在严格模式下运行时意外返回 null 却无感知。
- 是否启用返回类型由
symfony/maker-bundle版本和项目 PHP 版本共同决定：v1.40+ + PHP 8.0+ 才默认开启；旧版本或 PHP - 可通过配置强制开启：
config/packages/maker.yaml中添加maker: doctrine: enable_return_type_hints: true - 已有实体补加类型需手动修改，或删掉再跑
php bin/console make:entity --regenerate（注意：这会清空自定义逻辑）
用 --regenerate 重生成 getter/setter 会丢掉哪些代码？
php bin/console make:entity --regenerate 只重写 get*/set* 和 add*/remove* 方法，但会彻底覆盖整个方法体——包括你手写的逻辑、类型断言、日志、缓存处理等。
典型踩坑场景：你在 setCreatedAt() 里写了 $this->updatedAt = new \DateTimeImmutable();，一跑 --regenerate 就没了。
- 它不会对比差异，也不做合并，是「全量覆盖」行为
- 只识别标准命名（
setXxx,getXxx,addXxx,removeXxx），自定义方法名（如markAsPublished()）完全不受影响 - 如果只想更新某几个方法，不如直接手改，或用 IDE 的「Generate Getter and Setter」辅助（更可控）
关联字段（ManyToMany/OneToMany）的 add/remove 方法为什么有时不生成？
当 Doctrine 关联关系缺少 inversedBy 或 mappedBy 配置，或者目标实体尚未被 make:entity 创建过，make:entity 会跳过生成 addXxx/removeXxx 方法。
现象是：运行命令后，控制台提示「No add/remove methods generated for relation xxx」，但字段本身仍正常映射。
- 检查关联双方的注解或 YAML/PHP 配置，确保双向关系配对正确（比如
inversedBy="posts"对应mappedBy="author"） - 若目标实体是新建的，先执行
make:entity创建它，再回到原实体重新运行make:entity（不要加--regenerate） - OneToOne 关系默认不生成 add/remove，只有集合类（*ToMany）才生成——这是 Doctrine 语义决定的，不是 bug
想让生成的 setter 支持链式调用（return $this），怎么加？
make:entity 默认所有 setXxx() 返回 void，不支持链式调用。要改成 return $this;，必须手动改写。
这不是配置项能开关的功能，MakerBundle 没提供对应选项，强行改模板风险高且不可维护。
- 最稳妥做法：生成后全局搜索
public function set，逐个把void改成self（PHP 8.0+ 推荐）或static（兼容老版本），并在末尾加return $this; - 注意
setXxx()被多个地方调用时（如表单、API 请求），链式调用不会破坏原有逻辑，但需确认所有调用方没依赖void返回值 - 别碰
addXxx()/removeXxx()的返回类型——它们本就该返回void，改了反而违反 Doctrine Collection 接口契约
类型声明、链式调用、关联方法生成……这些都不是黑盒自动完成的事，得看 PHP 版本、MakerBundle 版本、Doctrine 配置三者咬合点在哪。漏掉一个条件，生成结果就和预期差一截。
