Composer自动加载依赖配置而非检测：PSR-4要求命名空间前缀（如"App"）与目录路径（如"src/"）严格对应，修改后必须运行composer dump-autoload生效；classmap适用于无命名空间的老代码，需手动刷新。
Composer 自动加载命名空间靠的是 autoload 配置，不是“检测”出来的
Composer 不会扫描你的代码去“猜”或“检测”命名空间。它只按 composer.json 里写的 autoload 规则（如 psr-4、psr-0、classmap）生成 vendor/autoload.php 中的映射表。你改了命名空间但没更新配置，它就完全不知道。
常见错误现象：Class "AppServicesUserService" not found，但文件明明在 src/Services/UserService.php —— 很可能只是 psr-4 的前缀或路径没对齐。
-
psr-4要求命名空间前缀（如"App\"）和目录路径（如"src/"）严格对应：文件src/Services/UserService.php必须声明namespace AppServices; - 路径末尾必须带斜杠（
"src/"），否则 Composer 会把它当文件名拼接，导致映射失败 - 修改
autoload后必须运行composer dump-autoload（或composer install/update），否则新规则不生效
什么时候该用 psr-4，什么时候该用 classmap
psr-4 是主流选择，适合标准结构（命名空间 = 目录路径），速度快、可扩展；classmap 是兜底方案，适合老代码、无命名空间、或动态生成类的场景。
- 用
psr-4：新项目、Laravel/Symfony 风格结构、所有类都有明确命名空间 - 用
classmap：含__autoload或require_once的传统 PHP 文件、第三方未遵循 PSR 的库、或某些测试辅助类（如tests/bootstrap.php里的工具类） -
classmap需要手动刷新：改了文件位置或新增了类文件，必须再跑一次composer dump-autoload -o（加-o表示优化）
composer dump-autoload 的几个关键参数影响实际行为
这个命令不是“重新扫描”，而是根据当前 composer.json 和文件系统现状，重建 vendor/composer/autoload_*.php 映射文件。不同参数决定映射方式和性能表现。
-
composer dump-autoload：仅生成基础映射，开发时够用 -
composer dump-autoload -o（--optimize）：合并所有类映射到单个autoload_classmap.php，跳过文件存在性检查，上线环境推荐 -
composer dump-autoload --no-dev：排除autoload-dev配置，避免把测试类打进生产 autoload - 如果用了
exclude-from-classmap，它只影响classmap生成，对psr-4无效
命名空间加载失败时，优先查这三处
别急着重写代码，90% 的问题出在这三个地方：
- 文件实际路径与
psr-4声明的根目录 + 命名空间不一致（例如配置了"App\": "src/"，但类写的是namespace AcmeServices;） -
composer.json改了但没执行composer dump-autoload，或者执行了却忘了加-o导致优化未生效（尤其在 CI/CD 环境中容易漏） - 文件编码或 BOM 头导致 PHP 解析失败，类没被正确声明——用
file -i yourclass.php检查编码，或用head -n1 | hexdump -C看有没有 EF BB BF
自动加载不是魔法，是配置驱动的静态映射。最易忽略的是：你以为改了命名空间，其实只是改了 use 语句，而 namespace 声明和目录结构根本没动。
