必须加 -o 参数才能彻底重建类映射；否则仅更新配置文件而不扫描磁盘PHP文件，导致新增或移动的类无法被加载。
强制重新生成自动加载文件，直接运行 composer dump-autoload 即可，但默认是“优化模式”，不会真正扫描文件——要彻底重建，必须加 -o 或 --optimize，否则可能仍用着旧的类映射。
为什么 composer dump-autoload 有时不生效？
因为 Composer 默认只刷新 autoloader 的配置结构（如 PSR-4 映射路径），并不重新扫描磁盘上的 PHP 文件；尤其在你手动增删了类文件、改了命名空间但没改 composer.json 时，旧的 vendor/autoload.php 仍会尝试加载不存在的类，或漏掉新类。
- 不加参数：仅重写
vendor/composer/autoload_psr4.php等配置文件，不触碰实际类文件扫描 - 加
-o：清空vendor/composer/autoload_classmap.php并全量扫描src/、lib/等所有 autoload 配置目录下的.php文件，生成新 classmap - 加
--no-optimize：反而退回到非优化模式，classmap 不生成，纯靠 PSR 规则动态定位——开发中调试可用，但生产环境性能差
dump-autoload 的常用组合参数
根据场景选对参数，比反复 install 或删 vendor 更快更安全：
-
composer dump-autoload -o：生产部署后强制刷新，确保 classmap 与当前代码完全一致 -
composer dump-autoload --optimize --classmap-authoritative：进一步启用权威 classmap 模式，遇到未声明类直接报错，不 fallback 到文件系统扫描 -
composer dump-autoload -a：仅重新生成 PSR-4/PSR-0 映射（不扫 classmap），适合只改了命名空间但类文件位置没变 -
composer dump-autoload -o --no-dev：生成不含测试类（如tests/）的精简 classmap，减小 autoload 文件体积
什么时候必须加 -o？
以下情况不加 -o 就等于没重载：
- 新增了一个
AppServicesPaymentService类，但运行时报Class "AppServicesPaymentService" not found - 把
src/Models/User.php移到了src/Domain/User.php，但 PSR-4 配置已更新，仍加载失败 - CI 流水线里执行了
composer install --no-dev，但后续又合入了 dev-only 的工具类，需要单独补扫
此时最简验证方式：
composer dump-autoload -o
php -r "require 'vendor/autoload.php'; var_dump(class_exists('App\Services\PaymentService'));"
classmap 生成逻辑依赖文件系统实时状态，而 Composer 缓存或 IDE 索引滞后常让人误判问题出在配置上——其实只是 autoload 文件根本没包含那个类。
