Composer自动加载生效需正确配置composer.json的autoload字段并执行composer dump-autoload；PSR-4要求命名空间前缀末尾带双反斜杠、路径末尾不带斜杠，classmap需手动重生成映射表。
Composer 的自动加载不是靠“教程”生成的，而是靠 composer.json 里写对了 autoload 配置、再执行 composer dump-autoload 才生效——漏掉这步或配错路径，require 就永远找不到你的类。
autoload 配置写在哪？不是写在 PHP 文件里
所有自动加载规则必须定义在项目根目录的 composer.json 中，不是写在 vendor/autoload.php 里，也不是靠手动 require。常见错误是改了类文件却忘了更新 composer.json，结果 composer 完全“看不见”新类。
-
"autoload": { "psr-4": { "App\": "src/" } }：最常用，类名前缀App\对应src/目录，文件路径必须严格匹配命名空间（比如AppHttpController→src/Http/Controller.php） -
"autoload": { "classmap": ["lib/", "scripts/"] }：适合老代码或无命名空间的类，composer 会扫描目录下所有 PHP 文件并记录类名与路径映射，但每次增删文件后必须重跑composer dump-autoload - 开发时加
"autoload-dev"独立配测试类，避免把tests/路径打进生产 autoload 映射
为什么 classmap 自动加载不生效？
classmap 不是实时监听文件变化的机制，它是一次性扫描生成静态映射表。你新增了一个 lib/Helper.php，但没重新生成 autoload，那这个类就永远不会被自动加载到。
- 执行
composer dump-autoload才会重新扫描classmap指定路径下的所有.php文件 - 如果用了
--optimize（即composer dump-autoload -o），会生成更紧凑的autoload_classmap.php，但开发中不建议常开——它会忽略动态注册的类，且修改文件后必须手动再 dump - 注意：classmap 扫描的是物理文件，不校验类名是否匹配文件名，所以容易因手误引入同名类冲突
PSR-4 映射路径写错的典型表现
报错 Class "AppServicesUserService" not found，但文件明明在 src/Services/UserService.php ——大概率是 composer.json 里写成了 "App\": "src/App/" 或漏了末尾斜杠，导致命名空间前缀和路径无法对齐。
- PSR-4 要求命名空间前缀末尾带反斜杠（
"App\"），路径末尾不带斜杠（"src"），否则 composer 会拼出错误的物理路径 - 子目录名必须和命名空间段完全一致，大小写敏感（Linux 下
src/Services/≠src/services/） - 如果类文件里声明的是
namespace AppServices;，那composer.json中"App\": "src/"是对的；若写成"App\Services\": "src/Services/"，反而会导致重复拼接
修改 autoload 后忘记 reload 会怎样？
改完 composer.json 不运行 composer dump-autoload，或者改了代码没清 opcache，就会出现“代码明明存在，却提示类未找到”的情况——这不是 PHP 问题，是 autoload 映射根本没更新。
-
vendor/autoload.php是入口文件，它只读取vendor/composer/autoload_*.php这些生成的映射文件，不会动态解析composer.json - CI/CD 中常漏掉这步，导致测试环境通过、生产环境报错
- Docker 构建时若把
vendor/当作缓存层，可能复用旧的 autoload 映射，务必在构建阶段显式执行composer dump-autoload
真正卡住人的从来不是语法，而是 autoload 映射和物理路径之间那层看似简单、实则容错极低的对应关系——少一个反斜杠、多一个目录层级、忘跑一次 dump，就足以让整个自动加载链失效。
