composer dump-autoload 不下载包，只重生成自动加载文件；强制刷新需清缓存、用 -o --no-dev 重建、验证路径与命名规范。
直接结论： composer dump-autoload 本身不下载或更新包，只重生成 vendor/autoload.php 和类映射文件；要“强制刷新”，关键在清缓存 + 强制重载 + 配合正确参数，而非反复执行默认命令。
为什么 dump-autoload 看似没生效？
常见现象：改了 composer.json 的 autoload 配置（如新增 psr-4 映射）、加了新类、删了旧类，但 php artisan tinker 或 php index.php 仍报 Class not found —— 实际是 Composer 缓存了旧的类映射，或未触发完整重建。
- Composer 8+ 默认启用 classmap 缓存（
vendor/composer/autoload_classmap.php），跳过扫描目录 - 若用
optimize-autoloader（即-o）生成过优化版，后续普通dump-autoload不会覆盖它 - 某些 IDE 或 CLI 进程（如已运行的
php -S）可能缓存了旧的 autoloader 实例
真正“强制刷新”的三步操作
不是加 --force（该参数不存在），而是组合清理、重建、验证：
- 删掉整个
vendor/composer/autoload_*.php文件（尤其autoload_classmap.php和autoload_static.php） - 运行：
composer dump-autoload -o --no-dev
（加-o强制走 classmap 生成路径，--no-dev避免 dev autoload 干扰） - 如果项目用 PSR-4，确认
composer.json中对应命名空间路径存在且可读："autoload": { "psr-4": { "App\\": "app/" } }，然后手动检查app/下是否有合法命名空间子目录（如app/Services/）
dump-autoload 常用参数差异与适用场景
不同参数影响生成逻辑和性能，选错反而拖慢开发：
-
-o（--optimize）：生成 classmap，跳过 PSR-4/PSR-0 动态查找，适合生产环境；但开发中改类名/路径后必须重跑，否则找不到 -
--classmap-authoritative：告诉 autoloader “所有类都在 classmap 里，别再去文件系统找”，配合-o使用；若漏扫（比如 gitignore 掉了某目录），直接报错 -
--apcu：启用 APCu 缓存 classmap（PHP >=7.0），需 APCu 扩展开启；本地开发一般不用，CI/CD 可考虑 - 不加任何参数：仅更新
autoload_static.php和静态映射，适合快速迭代小改动，但不解决 classmap 过期问题
容易被忽略的两个硬性前提
再怎么强制刷新，以下两点不满足，dump-autoload 就是白跑：
-
composer.json中的autoload或autoload-dev必须语法正确，且路径为相对项目根目录的**有效路径**（不能是../lib这种跨出项目根的写法） - 目标类文件必须满足命名规范：PSR-4 下，
App\Services\PaymentService必须位于app/Services/PaymentService.php，文件名大小写必须完全一致（Linux 环境下尤其敏感）
最麻烦的情况是：你改了 autoload 配置、清了缓存、跑了 -o，但类还是加载不到——这时候该去 vendor/composer/autoload_psr4.php 里搜你的命名空间，看生成的路径对不对，而不是怀疑命令没生效。
