应使用 composer install --no-dev --optimize-autoloader --prefer-dist；dump-autoload -o 不重建 classmap，仅 install/update 阶段加 -o 才能生成有效 autoload_classmap.php。
CI/CD 里该用 composer install --optimize-autoloader，不是 dump-autoload -o
绝大多数自动化打包脚本误用 composer dump-autoload -o，结果 vendor/composer/autoload_classmap.php 没生成或为空——因为 dump-autoload 默认不重建 classmap，它只刷新 PSR-4 映射和 autoload_static.php。真正触发 classmap 全量扫描并写入的，是 install 或 update 命令加 --optimize-autoloader 参数。
常见翻车点：
-
dump-autoload -o后检查vendor/composer/autoload_classmap.php，发现文件不存在或只有几行 —— 这是正常现象，不是命令没运行成功 - CI 脚本先
composer install，再补一句composer dump-autoload -o，以为“双重保险”——其实第二步完全无效，classmap 还是空的 - 用了
--classmap-authoritative却没配--no-dev，导致 dev 包里的测试类被扫进 classmap，但生产环境又不装它们，运行时报 Class not found
标准部署命令必须带 --no-dev 和 --prefer-dist
生产环境 classmap 生效的前提，是只包含实际运行时需要的类。dev 包（如 phpunit、mockery）的类路径若被扫进 autoload_classmap.php，不仅浪费空间，还可能因路径缺失引发加载失败。而 --prefer-dist 能加快下载速度，在 CI 中尤其关键。
推荐写死在构建脚本里的命令是：
composer install --no-dev --optimize-autoloader --prefer-dist
这个组合的效果：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
--no-dev：跳过 autoload-dev 块，且不安装 dev 依赖 → classmap 里不会混入 tests/ 或 vendor/bin/ 下的类 -
--optimize-autoloader：强制在 install 阶段执行 classmap 全量扫描 → 生成非空的autoload_classmap.php -
--prefer-dist：优先用 zip 包而非 git clone，节省 CI 时间，尤其对大依赖（如 laravel/framework）明显
验证是否真生效：别只看文件存在，要查内容和加载路径
光检查 vendor/composer/autoload_classmap.php 是否存在不够，它可能是个空数组。真正有效的验证方式有两步：
- 打开
vendor/composer/autoload_classmap.php，确认里面有一长串类似'App\Console\Command\Deploy' => $baseDir . '/app/Console/Command/Deploy.php'的映射条目，且数量在数百行以上 - 查看
vendor/composer/autoload_real.php，搜索addClassMap，确认第 50 行左右有$loader->addClassMap(include __DIR__ . '/autoload_classmap.php');—— 这说明加载器确实用了 classmap - 如果项目用了 Laravel，还可以跑
php artisan tinker -n然后输入app()->getNamespace()，再exit；观察首次启动耗时是否比未优化时下降 20%+（CLI 场景最敏感）
docker 构建时要注意 opcache 预热和配置继承
Docker 镜像里开了 --optimize-autoloader 却没提速？大概率是 PHP 的 opcache 没启用，或配置没继承到容器内。classmap 文件本身只是个大数组，真正快起来靠的是 opcache 缓存住它。
构建阶段需确保：
- Dockerfile 中 PHP 配置已开启 opcache：
opcache.enable=1、opcache.enable_cli=1（CLI 场景也需要）、opcache.memory_consumption=256 - 避免在容器启动时才生成 autoload 文件 —— 必须在
docker build阶段就执行composer install --no-dev --optimize-autoloader，让 autoload_classmap.php 和 opcache 编译结果一起打进镜像 - 不要在 entrypoint 里动态运行
composer dump-autoload—— 那会破坏镜像层缓存，且 CLI 模式下 opcache 不一定生效
classmap 优化不是银弹。它在 CLI、短生命周期任务（如部署钩子、队列 worker 启动）中收益明显；但在长驻进程（如 Swoole、Octane）里，效果会被 opcache 掩盖。真正容易被忽略的，是把 classmap 当成“万能加速”，却忘了删掉 composer.json 里 "docs/": ["docs/"] 这类无用 autoload 条目——它们会让 classmap 白扫几百个 Markdown 文件，体积暴涨却毫无用处。
