PSR-4映射写错时--optimize-autoloader无效：90%的“加了仍慢”源于autoload.psr-4配置错误，如"App": "app/"缺反斜杠、路径大小写不符或含.//绝对路径；优化只加速正确映射，不修复错误。
PSR-4 映射写错，优化根本没用
所有“加了 --optimize-autoloader 还是慢”的问题，90% 源于 composer.json 里 autoload.ps-r4 配置本身就不对——优化只加速正确的映射，不修复错误的映射。
常见错误包括：
-
"App": "app/"（缺末尾反斜杠）→ 应为"App\": "app/"（JSON 中双反斜杠表示一个字面量反斜杠） -
"App\": "App/"（路径大小写与实际目录不符，Linux 下App/≠app/） -
"App\": "./app/"或"App\": "/app/"（路径不能含.、..或绝对路径） - 命名空间声明行有前导空格：
namespace AppHttpController;→ 实际应为namespace AppHttpController;
验证方式：运行 php -r "var_dump(include 'vendor/composer/autoload_psr4.php');"，确认输出中 "App\" 对应的路径确实是 ["app/"]，且没有拼写或转义错误。
dump-autoload -o 不等于 classmap 全覆盖
composer dump-autoload -o 在 Composer 2.x 中默认只把 PSR-4 映射转成静态数组（写入 autoload_static.php），它不会扫描文件、也不会生成 autoload_classmap.php——除非你已经在 composer.json 的 autoload.classmap 字段里明确列出了要扫描的路径。
想让所有类走 classmap 查表（O(1) 查找），必须：
- 在
composer.json中显式添加"classmap": ["app/", "src/"] - 执行
composer dump-autoload -a（-a强制递归扫描并生成完整autoload_classmap.php） - 避免混入测试类：生产部署务必加
--no-dev，否则autoload-dev里的Tests\映射也会进 classmap
检查是否生效：打开 vendor/composer/autoload_classmap.php，搜索你的类名（如 'AppHttpControllersHomeController'），确认对应路径存在且正确。
生产环境必须加 --no-dev --optimize-autoloader
只加 --optimize-autoloader 不够，--no-dev 是关键开关——它会跳过 autoload-dev 里的映射，并让 classmap 只收录稳定依赖和主项目代码。
CI/CD 或 Docker 构建时，推荐固定命令：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
composer install --no-dev --optimize-autoloader --prefer-dist
这个组合的效果是：
- 不装
require-dev包，减小 vendor 体积 - 强制启用 classmap 模式（而非 fallback 到 PSR-4 动态拼接）
-
--prefer-dist避免源码克隆，加快安装
漏掉 --no-dev 会导致测试类混入 autoload_classmap.php，不仅增大文件，还可能引发命名冲突或意外加载。
opcache 和 APCu 才是真正的瓶颈
即使 classmap 已生成、路径全对，如果 PHP 的 opcache 未启用或配置不当，每次请求仍要重新编译 autoload_classmap.php——这时优化完全白费。
必须检查的 PHP 配置项：
-
opcache.enable=1（FPM/SAPI 均需开启） -
opcache.enable_cli=1（CLI 场景如 PHPUnit、部署脚本也需要） -
opcache.validate_timestamps=0（生产环境禁用时间戳校验，否则每次请求都 stat 文件） -
opcache.memory_consumption >= 128（确保大 classmap 数组能被完整缓存）
APCu 不缓存 classmap 数组本身，它缓存的是 Composer autoloader 实例；若要用 APCu 加速，得在构建时加 --apcu-autoloader，或运行时手动启用——但多数场景下，调优 opcache 就已足够。
最易被忽略的一点：classmap 优化只对首次加载有收益，后续请求靠的是 opcache 缓存。没配好 opcache，再好的 classmap 也只跑一次。
