composer require 不支持 --optimize-autoloader，因其不触发 classmap 生成；必须配合 composer install --no-dev --optimize-autoloader 或 composer update --optimize-autoloader 才能将新包纳入 autoload_classmap.php。
composer require 命令本身不支持 --optimize-autoloader 参数，强行加上会报错或被忽略——它不是 install 或 update，不会触发 autoload 重建逻辑。
为什么 composer require --optimize-autoloader 不生效
这是最常被误解的操作。你执行：
composer require monolog/monolog --optimize-autoloader
命令会成功安装包，但 vendor/composer/autoload_classmap.php 不会被生成或更新，原因如下：
-
require底层调用的是update流程，但它默认跳过 classmap 扫描阶段，除非显式加--optimize-autoloader到update本身（而require不透传该参数） - Composer 2.x 起，
require的行为更偏向“增量添加”，不重跑完整 autoload 构建，避免干扰已有 classmap 稳定性 - 即使你配置了
"optimize-autoloader": true，require也不会因此自动启用 classmap 生成——它只影响后续的install/update
真正能生成 classmap 的组合命令
要让新引入的包类进 classmap，必须走完整构建流程。以下才是有效写法：
-
composer require monolog/monolog && composer install --no-dev --optimize-autoloader（推荐：先加依赖，再全量优化） -
composer require monolog/monolog --update-with-dependencies && composer update --no-dev --optimize-autoloader（适合需同步升级依赖链的场景） - 如果只是本地开发调试，可省略
--no-dev，但线上部署必须带上
注意：composer update --optimize-autoloader 单独运行也有效，但它会重新解析所有包，可能拉取 dev 版本，不如 install 稳定。
检查 classmap 是否真包含新包
别只信命令输出，直接验证文件和内容：
- 运行
ls -l vendor/composer/autoload_classmap.php—— 文件存在且大小 >10KB 才算有实质内容 - 用
grep -i monolog vendor/composer/autoload_classmap.php确认是否出现类似'Monolog\Logger' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Logger.php'的条目 - 若 grep 无结果，说明该包未被扫描进 classmap —— 可能因为其
composer.json没声明autoload或用了files类型（这类文件不会进 classmap）
容易踩的坑：require 后 dump-autoload -o 白忙一场
很多人会补救式执行：
composer require monolog/monolog composer dump-autoload -o
这几乎一定失败，因为：
-
dump-autoload -o在 Composer 2.x + PHP 7.4+ 下默认不生成autoload_classmap.php，只刷新 PSR-4 映射 - 它不会重新扫描 vendor 目录下的新包，也不会处理
monolog/monolog的 autoload 配置 - 最终
autoload_classmap.php仍为空或仅含旧类，类加载仍走慢路径
真正要补救，只能删掉 vendor/composer/autoload_classmap.php，然后跑 composer install --no-dev --optimize-autoloader 重来。
实际部署中，classmap 是否完整、是否剔除了 dev 类、是否与 opcache 协同工作，三者缺一不可。漏掉任一环，--optimize-autoloader 就只是个没加载的空文件。
