composer dump-autoload -o 没效果是因为 -o 仅优化 classmap 加载器，而默认 psr-4 依赖实时文件查找；需在 composer.json 中显式配置 autoload.classmap 并运行 composer dump-autoload -a，同时生产环境务必使用 --no-dev --optimize-autoloader。
composer dump-autoload -o 为什么没效果？
直接运行 composer dump-autoload -o 却没看到加载变快，大概率是因为你的项目用了 PSR-4 自动加载且类文件结构不规范。-o（optimize）参数只对 classmap 加载器生效，而默认的 PSR-4 是按命名空间实时查文件路径的，根本绕不开文件系统调用。
- 只有当你显式配置了
"classmap"或使用"files"加载方式时，-o 才会生成扁平化的vendor/composer/autoload_classmap.php - PSR-4 规则下，
-o实际上只是把 PSR-4 映射转成 classmap 格式——但前提是所有类文件能被完整扫描到 - 常见漏扫：测试目录（
tests/）、私有工具类（src/Utils/但未在composer.json的autoload.psrr-4中声明）、带点号或下划线的文件名（如My_Controller.php）
怎么让 classmap 真正覆盖全部类？
别依赖自动扫描，主动收拢入口。Composer 的 classmap 生成逻辑很老实：它只遍历你明确告诉它的路径，然后递归收集所有 .php 文件里的 class、interface、trait 声明。
- 在
composer.json的autoload.classmap里写死关键目录："autoload": { "classmap": ["src/", "lib/", "app/Exceptions/"] } - 删掉冗余的 PSR-4 配置——如果 src/ 下全是标准命名空间，反而建议全切到 classmap，省去路径拼接和 realpath() 调用
- 运行
composer dump-autoload -a（-a 强制重扫 classmap，比 -o 更彻底） - 检查生成的
vendor/composer/autoload_classmap.php是否包含你预期的类名，比如'App\Http\Controllers\HomeController'对应的文件路径是否正确
APCu 缓存 classmap 后还是慢？
classmap 本身是纯数组查找，O(1)，瓶颈往往不在 PHP 层。如果启用了 APCu 但没提速，问题通常出在缓存未命中或配置错位。
- 确认
apc.enabled=1且apc.stat=0（否则每次 require 都会 stat 文件，废掉 classmap 优势） - classmap 数组本身不会被 APCu 缓存——真正要缓存的是 Composer 的 autoloader 实例，得靠
composer install --apcu-autoloader或运行时手动启用：$loader = require 'vendor/autoload.php'; $loader->setApcuPrefix('myapp'); - 注意 APCu 的内存限制：
apc.shm_size=64M，classmap 数组过大（比如超 5000 个类）可能触发逐出，反而增加 cache miss
生产环境必须关掉 autoload-dev 吗？
不是“必须”，而是“不关就白优化”。dev 相关的 autoload（如 autoload-dev 下的 psr-4 或 classmap）在 composer install --no-dev 时会被完全忽略，但如果你没加这个参数，Composer 仍会把测试类、Mock 工具等塞进 classmap，徒增内存占用和查找开销。
- 上线部署务必用
composer install --no-dev --optimize-autoloader - CI/CD 流水线里检查是否误带了
autoload-dev路径进生产包，一个tests/目录混进去，classmap 可能多出上千行无用映射 - 某些框架（如 Laravel）会在
bootstrap/autoload.php里手动 require vendor/autoload.php，此时若没走 --no-dev，dev 类依然可能被加载——得看框架底层是否做了隔离
