composer 不提供动态命名空间注入，仅支持静态 psr-4 映射；composer.json 中命名空间必须用双反斜杠转义且末尾带反斜杠，修改后需执行 composer dump-autoload -o；namespace、路径、文件名三者须完全一致；服务自动发现需手动实现反射扫描逻辑；autoload-dev 必须单独配置以隔离测试类。
Composer 本身不提供“动态命名空间注入”这种运行时机制——它只做静态映射和自动加载，所谓“动态”其实是开发者在 PSR-4 基础上叠加的约定+反射逻辑，并非 Composer 内置能力。
composer.json 里写错反斜杠，类就永远找不到
PSR-4 映射键必须是带双反斜杠的完整命名空间字符串，比如 "App\Services\"，不是 "AppServices"（单反斜杠在 JSON 中会被转义为 "AppServices"），更不能漏掉末尾反斜杠。一旦写成 "AppServices"，Composer 就会把 AppServicesEmailService 拼成 src/Services/EmailService.php → src/ServicesEmailService.php，文件根本不存在。
-
"App\Services\"✅：JSON 解析后是AppServices，匹配成功 -
"AppServices\"❌：JSON 解析失败，实际变成AppServices，前缀截断 -
"App\Controllers"❌：缺少末尾反斜杠，导致App\Controllers\Home被映射到src/ControllersHome.php - 改完
composer.json后必须手动执行composer dump-autoload -o，否则vendor/autoload.php不更新
namespace、路径、文件名三者必须严丝合缝
“Class not found” 错误 90% 都出在这三处不一致：
- PHP 文件顶部的
namespace声明必须和composer.json里写的完全一致，包括大小写和层级顺序 - 文件物理路径必须严格对应命名空间层级：例如
namespace AppHttpControllers;→ 文件必须放在src/Http/Controllers/目录下 - 类名必须与文件名完全一致（大小写敏感）：
class HomeController→ 文件必须叫HomeController.php，不能是homecontroller.php或HomeControllerController.php - Linux 系统下路径大小写敏感，
src/http/controllers/和src/Http/Controllers/是两个不同路径
想“动态发现服务”？得自己加一层反射逻辑
Composer 只负责“按命名空间找文件并加载”，不负责“扫描所有类、判断哪些是服务、自动注册进容器”。真要实现服务自动发现，得额外写代码：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
glob('src/Services/**/*.php')扫描所有 PHP 文件 - 用
token_get_all()或ReflectionClass提取每个文件里的namespace和class名 - 过滤出实现了某个接口（如
ServiceInterface）的类 - 把它们实例化或注册进 DI 容器，比如
$container->bind(EmailService::class, EmailService::class) - 注意：这类扫描逻辑不能放生产环境自动执行，应只在开发或部署时生成缓存
autoload-dev 配置不是可选项，是安全边界
测试类（比如 TestsUnitUserTest）绝不能出现在生产自动加载表里：
- 它们通常依赖 PHPUnit、Mockery 等开发专用包，线上没装就会报错
- 如果误配进
"psr-4": {"App\": "src/"}，Composer 会把Tests目录也纳入扫描，增大内存开销 - 正确做法是在
composer.json里单独配"autoload-dev"：
{
"autoload-dev": {
"psr-4": {
"Tests\": "tests/"
}
}
}
然后只在测试启动时 require vendor/autoload.php，生产环境不会加载 Tests 下任何类。
真正容易被忽略的是：Composer 的“自动发现”本质是静态映射，所谓动态，全是人写的反射+约定逻辑。别指望改几行 JSON 就让框架自动识别新服务——你得明确告诉它“哪些类算服务”，否则它连 class 关键字都懒得看一眼。
