composer dump-autoload 变慢是因为默认混合 autoload 模式含大量 file_exists/is_dir 检查；加 --optimize 可生成 classmap 提升性能，但需确保所有类路径被正确扫描。
为什么 composer dump-autoload 会变慢？
项目依赖多、类文件数量大（尤其含大量第三方包或自定义 PSR-4 映射）时，Composer 默认生成的自动加载器会包含大量条件判断和文件存在检查，每次 require 都要遍历这些逻辑。这不是 PHP 解析慢，而是自动加载器本身“太啰嗦”。
根本原因是：默认模式下 Composer 生成的是“映射式 + 文件查找式”混合 autoload，既建了类名到路径的 map，又保留了按命名空间规则实时扫描目录的行为 —— 安全但冗余。
- 开发阶段频繁改类名/目录结构？别用
--optimize，它会跳过动态查找，改完不dump-autoload就报Class not found - 生产环境部署后不再增删类？必须加
--optimize，否则每次请求都触发file_exists()和is_dir()多达数百次 -
--classmap-authoritative比--optimize更激进：它直接声明“所有类都在 classmap 里”，连 PSR-4 的 fallback 查找都关掉 —— 类没进 map 就真找不到
dump-autoload --optimize 实际做了什么？
它强制 Composer 扫描所有 PSR-0/PSR-4 路径，把每个类文件的完整路径写进 vendor/composer/autoload_classmap.php，然后让自动加载器只查这张表，跳过所有 glob() 和 scandir()。
效果明显：Laravel 项目启用后，单次请求中自动加载耗时从 ~8ms 降到 ~0.3ms（Xdebug profile 数据）；但代价是构建时间增加 2–5 秒（取决于文件数）。
- 只对
"autoload"和"autoload-dev"中声明的路径生效，files类型不受影响 - 不会重新生成
autoload_files.php或修改autoload_psr4.php结构，只是让它们“被忽略” - 如果某类在 PSR-4 规则下本该被找到，但因路径权限/符号链接问题没被扫描到，
--optimize后它就彻底消失了
--classmap-authoritative 和 --optimize 到底差在哪？
--optimize 是“优先走 classmap，找不到再 fallback 到 PSR-4 规则”，而 --classmap-authoritative 是“只走 classmap，其他一概不管”。后者更快，也更脆。
典型翻车场景：tests/ 目录没写进 autoload-dev，但你在测试里用了 new TestHelper() —— 开发时能跑，加了 --classmap-authoritative 就直接 Class 'TestHelper' not found。
- 必须确保所有运行时可能用到的类，都落在
autoload或autoload-dev声明的路径里 - CI/CD 构建时建议用
composer dump-autoload --classmap-authoritative --no-dev，省掉 dev 依赖的 classmap 节省体积 - 本地开发慎用：改一个测试类名，就得手动
dump-autoload，IDE 自动补全也可能滞后
哪些情况加了参数也没用？
如果项目里混用了 files 加载（比如直接 require 函数文件）、或依赖了用 include_once 硬编码路径的包，--optimize 和 --classmap-authoritative 对这些完全无感 —— 它们压根不走 Composer 自动加载流程。
还有更隐蔽的坑：某些包在 autoload 里写了 "psr-4": {"Foo\": "src/"}，但实际类文件放在 src/Foo/Bar.php 里，命名空间却是 namespace Bar; —— 这种错位会导致 classmap 里没这条记录，优化后直接失效。
- 检查 classmap 是否完整：看
vendor/composer/autoload_classmap.php里有没有你确认存在的类名 - 验证是否生效：临时删掉
vendor/composer/autoload_psr4.php，如果还能跑，说明 classmap 确实接管了 - 私有包若用 git submodules 或 symlink 引入，确保
composer dump-autoload时当前工作目录能穿透链接读到文件
composer dump-autoload --classmap-authoritative --no-dev 是常规操作，但别把它当万能开关 —— classmap 的完整性，得靠你写的 autoload 配置和目录结构共同保证。 
