结论：--optimize-autoloader 在 php 7.4+ + composer 2.x 下非默认提速项，用错反拖慢冷启动；真正有效组合是 --no-dev + --prefer-dist + --classmap-authoritative，且须严格清理 autoload 配置。
直接说结论：--optimize-autoloader 在 PHP 7.4+ + Composer 2.x 环境下，**不是默认提速项，用错反而拖慢冷启动**；真正有效的组合是 --no-dev + --prefer-dist + --classmap-authoritative，且必须配合严格的 autoload 配置清理。
为什么 composer dump-autoload -o 在新项目里没效果
它只生成全量 autoload_classmap.php，而 Composer 2 默认已用更轻量的 autoload_static.php。这个文件是预编译静态数组，OPcache 友好；-o 生成的 classmap 是动态 require 的大数组，每次请求都要反序列化或解析——哪怕只用一个类，也得载入几 MB 数据。
- 常见误操作：在
composer.json里写了"optimize-autoloader": true，但没配--no-dev，结果把tests/、examples/全扫进 classmap，体积翻倍 - 真实瓶颈不在“查不到类”，而在“加载了根本不用的类路径”——比如 Laravel 项目中，一次 HTTP 请求实际加载的类通常不到总类数的 5%
- 验证方法：删掉
vendor/composer/autoload_classmap.php，执行composer install --no-dev --prefer-dist，看是否仍能正常运行
--classmap-authoritative 必须满足的 4 个前提
它不是开关，是契约：一旦启用，Composer 就认定“classmap 之外无类”。不满足以下任意一条，就会静默报 Class not found，且错误不提示真实原因。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
autoload块里不能有"files"条目（如全局函数文件），否则这些函数不会被收录进 classmap，但又因 authoritative 模式被跳过加载 - 所有类路径必须严格符合 PSR-4 规则：命名空间末尾带反斜杠、目录结构与命名空间层级完全一致、大小写敏感（Linux 服务器上尤其致命）
-
autoload-dev必须和autoload完全分离，生产部署时一定要加--no-dev，否则测试类会混入主 autoload 映射 - 私有包的
composer.json中需声明"archive": {"exclude": ["/tests", "/docs"]}，否则 Satis 构建时会把废弃路径哈希写入 lock 文件，间接污染 classmap 扫描范围
私有仓库项目里 classmap 生效的硬性条件
私有包的类要进最终 classmap，光靠 --optimize-autoloader 不够，必须让 Composer “看得见、扫得全、收得准”。
- URL 末尾必须带
/：例如https://artifactory.example.com/repo/，漏掉斜杠会被识别为不同源，导致元数据 fallback 失败，classmap 根本不触发生成 - 后端仓库 type 必须是
composer，不能是generic；Artifactory 虚拟仓库需确保至少一个type: composer的本地或远程源启用 - 私有包自己的
composer.json中，autoload.psrr-4的前缀不能写成""（空字符串），否则会递归扫描整个包根目录，把.git、CHANGELOG.md全当 PHP 文件处理 - 若私有包含非标准路径类（如
src/Utils/My_Controller.php），必须显式加到autoload.classmap数组里，不能依赖 PSR-4 自动推导
CI/CD 流水线里最该固化的一条命令
别再拆成多步：先 install，再 dump-autoload，最后 clear-cache。这会破坏 OPcache 缓存一致性，且浪费构建时间。
- 标准命令：
composer install --no-dev --prefer-dist --classmap-authoritative - 务必禁用 Xdebug：
php -d xdebug.mode=off composer install ...，Xdebug 会让--classmap-authoritative的性能收益归零 - 如果用了 APCu，加
--apcu-autoloader，但注意它和--classmap-authoritative互斥——选前者要接受 fallback 查找开销，选后者要确保 classmap 100% 覆盖 - 大型项目建议定期跑
composer update --lock（不带包名），压缩composer.lock中已废弃的 dev 包元数据，12MB 的 lock 文件降到 3MB 后，JSON 解析耗时下降超 60%
最容易被忽略的点：classmap 是否生效，不取决于你加了多少参数，而取决于 vendor/composer/autoload_static.php 里有没有你实际用到的类——这个文件由 Composer 2 自动生成，无法手动编辑，一旦配置有歧义（比如命名空间重复注册、路径大小写混乱），它就 quietly 放弃优化。
