加-o参数才能生成真正优化的classmap映射表，否则仅刷新PSR-4映射、仍需每次调用file_exists()做I/O判断；加-o后硬编码所有类路径到autoload_classmap.php，跳过文件系统扫描，实测减少30%~50%自动加载开销。
composer dump-autoload -o 为什么在生产环境必须加 -o 参数
不加 -o 生成的是未优化的 autoload map，PHP 每次 require 类时都要遍历整个 psr-4 或 classmap 映射表；加了 -o 后，Composer 会把所有类路径一次性写入 vendor/composer/autoload_classmap.php，跳过文件系统扫描，直接查表加载——实测可减少 30%~50% 的自动加载开销。
常见错误：CI/CD 流程里只跑 composer install --no-dev，却漏掉 -o，导致上线后 autoloader 性能没提升。
-
composer dump-autoload -o必须在composer.json中已配置好 autoload 规则（如"autoload": {"psr-4": {...}}），否则生成的 classmap 为空 - 如果项目含大量散列小文件（比如旧版 Laravel 的 helpers.php），
-o仍会生效，但建议改用classmap显式声明，避免漏扫 -
-o会忽略autoload-dev部分，这点和--no-dev无关，是 dump-autoload 自身行为
composer install --optimize-autoloader 和 dump-autoload -o 的区别
两者最终效果一致，都生成优化后的 classmap，但触发时机和适用场景不同：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer install --optimize-autoloader：适合部署时从零安装依赖，它会在安装完包后自动执行dump-autoload -o -
composer dump-autoload -o：适合已有 vendor 目录的环境（比如容器内热更新），无需重装包，更快更轻量 - 若已运行过
composer install --no-dev，再补dump-autoload -o是安全且推荐的操作；反过来，如果只跑install --optimize-autoloader却没加--no-dev，dev 包的类仍会被扫进 classmap（虽不影响运行，但浪费空间）
如何验证 classmap 是否真正生效
别只看命令是否成功，要确认实际加载行为：
- 检查
vendor/composer/autoload_classmap.php文件大小 —— 生产项目该文件通常 >100KB；若只有几 KB，说明没扫到类（常见于未执行composer dump-autoload -o或 autoload 配置路径错误） - 在代码中临时加一句
var_dump(\Composer\Autoload\ClassLoader::getRegisteredLoaders());，观察返回数组中classMapAuthoritative是否为true（-o模式下才为 true） - 用
strace -e trace=openat php -r "new \Some\Class();"看是否跳过了大量openat调用 —— 优化前可能有上百次文件探测，优化后只剩 classmap 文件本身和目标 .php 文件两次
CI/CD 中容易漏掉的细节
很多团队在 GitHub Actions 或 Jenkins 里写了 composer install --no-dev，却忘了后续步骤：
- 如果使用 Docker 构建镜像，
vendor/在构建阶段生成，必须在RUN指令里明确追加&& composer dump-autoload -o，不能指望 runtime 再执行 - 某些部署脚本用
rsync同步 vendor 目录，但没同步vendor/composer/autoload_classmap.php—— 这个文件是生成的，不是 git 跟踪的，必须确保它随 vendor 一起传输 - Laravel 用户注意：
php artisan config:clear不影响 autoload，但php artisan optimize:clear（Laravel 9+ 已弃用）曾会删掉 classmap，现在只需确保dump-autoload -o在缓存清理之后执行
classmap 不是“设一次就永久有效”的东西，只要类文件增删或 autoload 配置变动，就必须重新生成。最稳妥的做法，是在每次部署流程末尾固定加上 composer dump-autoload -o，哪怕看起来冗余。
