Composer dump-autoload命令是做什么的？（优化性能必知）

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，能避开一大半“找不到类”的低级故障。