composer dump-autoload 是刷新 PHP 类自动加载映射的命令，根据 composer.json 的 autoload 配置重新生成 vendor/composer/autoload_*.php 文件，不装包、不联网、不改依赖；常用场景包括新增类、修改目录结构或调整 autoload 配置；生产环境推荐使用 -o --no-dev 优化性能。
composer dump-autoload 是用来刷新 PHP 类自动加载“地图”的命令。它不装包、不联网、不改依赖，只做一件事：根据当前 composer.json 里的 autoload 配置，重新扫描项目目录，生成或更新 vendor/composer/autoload_*.php 这些映射文件。类找不到、命名空间失效、新服务类用不上？运行它，往往立刻解决。
什么时候必须用它
你手动加了类、改了目录结构、或者调整了 composer.json 中的 "autoload"（比如 psr-4 路径或 classmap），Composer 就不会自动感知这些变化——它只在 install 或 update 时扫描一次。这时就得主动执行：
- 新增一个
app/Console/Commands/DeployCommand.php，且composer.json已配好"App\\Console\\Commands\\": "app/Console/Commands/" - 把
src/改成lib/，并同步更新了 psr-4 配置 - CI/CD 流水线中部署前确保 autoload 映射与代码一致，避免“Class not found”中断上线
怎么用它提升性能
开发环境默认生成的是“动态解析型”映射，每次加载类都要按规则推路径；生产环境应启用优化模式，让 Composer 提前算好所有类的位置，运行时直接查表：
-
composer dump-autoload -o：生成完整 classmap，跳过目录遍历，中小项目提速明显，Laravel 启动可快 3–5ms -
composer dump-autoload -o --no-dev：排除测试类等开发专用映射，文件更小、加载更快 -
composer dump-autoload -o -a：启用权威类映射（authoritative），Composer 不再 fallback 到 PSR-4 推断，彻底省掉 stat() 系统调用——适合类结构稳定的线上环境
它和 install/update 的区别
很多人误以为 composer install 总是包含最新 autoload，其实不然：
-
install只在vendor/不存在或composer.lock变更时才重生成 autoload -
update侧重更新包版本，autoload 只是附带刷新，还可能因缓存跳过扫描 -
dump-autoload是轻量、确定、可控的刷新方式，无网络请求，毫秒级完成，CI 脚本里推荐显式调用
基本上就这些。不复杂但容易忽略，尤其在本地调试新加类或上线前检查时，顺手跑一条 composer dump-autoload -o --no-dev，能避开一大半“找不到类”的低级故障。
