手动配置服务必须显式声明class、autowire和public，缺一不可：仅写服务ID不带class块则注册失败；autowire控制参数注入方式，false时须配arguments；public默认为false，需显式设true才能用$container->get()获取。
手动配置服务定义不是“写个 class 就完事”，而是必须显式声明 class、控制 autowire 行为、决定 public 状态——漏掉任意一项，服务就可能注册失败、无法注入、或调用报错。
services.yaml 里必须写 class 才算真正注册
只写 App\Service\EmailSender:（末尾带冒号但没配置块）在 Symfony 6.2+ 中不会报错，但该服务根本不会被容器识别。容器需要明确的 class 参数才能实例化对象。
- ✅ 正确写法：
App\Service\EmailSender: class: App\Service\EmailSender - ❌ 错误写法：
App\Service\EmailSender:（无class，等同于未定义） - 如果类有构造参数且你希望自动注入，加上
autowire: true；否则必须用arguments:手动传参
autowire: true 和 autowire: false 的实际影响
autowire 只控制构造函数参数是否自动解析，跟“服务是否注册”完全无关。很多人误以为关掉 autowire 就等于“不依赖注入”，其实它只是把注入权交给你手动处理。
-
autowire: true：容器会扫描构造函数类型提示，尝试匹配已注册服务（如MailerInterface）并注入 -
autowire: false：容器不看构造函数签名，你必须用arguments:显式列出每个参数，哪怕值是null或字符串 - 常见坑：
autowire: false却没写arguments:→ 报错Too few arguments to function __construct()
public: true 不是默认值，不设就拿不到服务实例
默认所有手动定义的服务都是 public: false。这意味着你不能在控制器或命令里用 $container->get('App\Service\EmailSender') 直接获取——会抛出 ServiceNotFoundException 或提示 “The service is private”。
- 需要全局可获取（比如在命令行脚本、事件监听器中主动拉取）→ 必须加
public: true - 仅用于类型注入（如控制器构造函数里自动塞进来）→
public: false安全且推荐 - 检查方式：运行
bin/console debug:container EmailSender，看输出里有没有Public: yes
别让自动加载和手动定义重复注册同一服务
如果你同时启用了 App\: resource: '../src/' 扫描，又在 services.yaml 里手动写了 App\Service\EmailSender:，Symfony 会注册两个同名服务：一个来自自动发现（private），一个来自手动定义（可能 public）。结果是后者覆盖前者，但调试时容易混淆。
- 查重方法：
bin/console debug:container --types | grep EmailSender，若出现两行说明有重复 - 解决思路：要么关掉自动扫描对应命名空间，要么删掉手动定义，统一用一种方式
- 特别注意：#[AsService] 注解 + 自动扫描 是互斥于手动定义的，混用会导致不可预测的覆盖行为
最常被忽略的一点：YAML 缩进是语法核心，class、autowire、public 必须在同一级缩进下，差一个空格就会导致整个服务块被忽略——而 Symfony 往往不报错，只静默跳过。
