--optimize-autoloader在本地无效，因开发环境默认启用classmap+PSR-4双模式加载器，生成的autoload_classmap.php不被优先使用；仅在--no-dev或minimum-stability=stable的生产环境下才切换为纯classmap模式，跳过路径拼接和file_exists()检查。
composer install --optimize-autoloader 为什么在本地没效果
因为开发环境下 vendor/autoload.php 默认启用 classmap + PSR-4 双模式加载器，--optimize-autoloader 生成的 autoload_classmap.php 不会被主加载器优先使用。只有在生产环境（即启用 --no-dev 或 "minimum-stability": "stable"）下，Composer 才会切换为纯 classmap 模式，跳过运行时路径拼接和 file_exists() 检查。
常见错误现象：composer install -o 后请求耗时几乎不变，strace 显示大量失败的 stat("/path/to/src/Http/Controller.php") —— 实际仍在走 PSR-4 动态查找。
- 本地开发默认加载器会 fallback 到 PSR-4，classmap 仅作补充，不提速
- 生产环境必须加
--no-dev，否则 classmap 生成了但被忽略 -
"optimize-autoloader": true写在composer.json里只是默认开关，不触发实际动作，也不清除旧缓存
CI/CD 中 composer install 必须带哪些参数才真正生效
部署脚本里只写 composer install -o 是典型翻车点：漏掉 --no-dev 就等于白优化。真实生效组合是强制锁定生产行为 + 强制启用 classmap 路径映射。
-
composer install --no-dev --optimize-autoloader --prefer-dist是推荐写死的最小安全集 - 加
--no-dev不仅跳过 dev 依赖安装，更关键的是让加载器切换为 classmap-only 模式 -
--prefer-dist避免源码解压开销，配合 classmap 加速更明显 - 若项目含
autoload-dev（如"Tests": "tests/"），不加--no-dev会导致测试类路径也被塞进 classmap，污染生产环境
classmap-authoritative 开启后 Class not found 怎么排查
--classmap-authoritative（或 -a）不是“更快的 autoload”，而是“更严格的 autoload”：类不在 autoload_classmap.php 里就直接报错，不再尝试拼路径、不调用 file_exists()。
报错不是配置错了，是 classmap 漏了类。常见漏扫场景：
- PSR-4 前缀末尾缺反斜杠，如
"App": "app/"应为"App\": "app/"（Windows 下尤其敏感） - 文件名与类名不严格匹配：如
My_Controller.php里定义class My_Controller，但 Composer 只收录MyController.php类型 - 动态类名逻辑（
$class = $prefix . $name; new $class();）、eval()、条件加载的文件，根本不会被扫描进 classmap - 检查
vendor/composer/autoload_classmap.php是否真包含目标类名（全文搜索），并确认对应 PHP 文件存在、大小写完全一致（src/Http/Controllers/≠src/http/controllers/）
dump-autoload -o 和 install -o 到底该用哪个
直接结论：composer install --optimize-autoloader 才是生产环境真正生效的命令；composer dump-autoload -o 在绝大多数项目里无效。
原因很实在：Composer 的 classmap 文件只在 install 或 update 时生成，而 dump-autoload 默认只刷新 PSR-4 映射、重写 autoload_static.php 等轻量文件，不重建 autoload_classmap.php —— 除非你同时用了 --classmap-authoritative 或项目里明确定义了 "classmap" 配置项。
-
composer dump-autoload -o后发现autoload_classmap.php文件根本没更新，甚至不存在，就是典型信号 - 如果项目有
"classmap": ["src/"]配置，dump-autoload -a才会强制重扫并生成 classmap；但此时仍需--no-dev配合才能启用 - Docker 构建时，务必在构建阶段（
RUN composer install --no-dev -o）执行，不能拖到容器启动时——否则 classmap 路径在运行时失效
最容易被忽略的一点：优化只加速「已知存在」的类加载；一旦漏掉 dump-autoload、路径写错、或命名空间配置有歧义，它不会报错，只会默默 fallback 失败——而 classmap 模式连尝试路径都不提示，排查成本反而更高。
