Composer autoload配置错误导致Class not found的根本原因是PSR-4命名空间与路径未严格对齐，如namespace缺结尾反斜杠、路径非相对于composer.json、classmap未及时更新或autoload-dev在--no-dev下失效。
composer.json 里 autoload 字段写不对，类就找不到
autoload 配置错一个字母，composer dump-autoload 不报错，但运行时直接 Class not found。根本原因不是“没加载”，而是 PSR-4 映射路径和命名空间不严格对齐。
- PSR-4 要求
namespace必须以结尾（如"App\": "src/"），漏掉反斜杠会静默失效 -
"src/"是相对于composer.json所在目录的路径，不是相对于项目根或 vendor - 如果用
classmap，记得每次增删文件后手动执行composer dump-autoload，它不会自动扫描 - 别把
files里写成相对路径如"helpers.php"—— 必须是相对于composer.json的完整路径，比如"src/helpers.php"
PSR-4 和 classmap 混用时，优先级和性能差异
PSR-4 是按命名空间动态映射，classmap 是生成静态数组。两者共存时，Composer 优先走 PSR-4；但一旦某个类没匹配上 PSR-4 规则，就会 fallback 到 classmap 查找。
- PSR-4 更灵活，适合常规类库；classmap 适合全局函数、Traits 或非标准结构（如
Foo_Bar类名） - classmap 生成后体积大、更新不及时，
composer dump-autoload -o会把所有 classmap 合并进优化后的autoload_classmap.php，但 PSR-4 映射仍保留在autoload_psr4.php中 - 开发中频繁改文件名/命名空间，别开
-o，否则 classmap 不自动刷新，容易误以为代码没生效
autoload-dev 只在 dev 环境生效，但测试类路径常被忽略
autoload-dev 下的配置（如 "Tests": "tests/"）只在 require-dev 安装且未加 --no-dev 时才载入。CI 环境若用了 --no-dev，Tests 命名空间就彻底不可用。
- PHPUnit 自动发现测试类依赖这个映射，映射错会导致
Class 'TestsTestCase' not found - 不要把测试类塞进
autoload主区——上线包会多带一堆测试代码 - 如果测试类需要引用 src 下的类，确保
autoload主区已正确定义，autoload-dev只管自己那块
修改 autoload 后 composer dump-autoload 不生效？检查这三点
常见现象：改完 composer.json，执行 composer dump-autoload，但 var_dump(class_exists('App\Service')) 还是 false。
- 确认当前执行命令的目录是
composer.json所在目录，不是子目录（比如在src/下执行无效） - 检查是否启用了 Composer 插件（如
hirak/prestissimo）导致缓存干扰，可临时加--no-plugins重试 - 运行
composer show --platform看 PHP 版本，某些老版本 Composer 对 PHP 8.1+ 的命名空间语法支持不全，会跳过解析
最麻烦的情况是 vendor/autoload.php 被其他脚本提前引入了——autoload 配置变更只影响下一次 require，之前已加载的映射不会刷新。调试时建议重启 CLI 进程或 Web 服务器。
