--classmap-authoritative 能提升 autoloader 性能，因为它强制 Composer 完全跳过 PSR-4/PSR-0 文件系统扫描，仅依赖静态 classmap 查找类；启用需满足所有类均已入 map，且须配合 --optimize-autoloader，不适用于动态生成类或手动 require 未声明类的场景。

为什么 --classmap-authoritative 能提升 autoloader 性能

它强制 Composer 完全跳过 PSR-4/PSR-0 的文件系统扫描，只依赖生成的 classmap 查找类。这意味着每次 new Foo() 或 class_exists('Bar') 时，PHP 不再需要遍历 vendor/autoload_psr4.php 中的路径前缀、拼接文件名、再调用 file_exists() 检查——所有类位置已在 vendor/composer/autoload_classmap.php 中静态映射好。

--classmap-authoritative 的启用条件与副作用

该参数仅在 composer install 或 composer update 时生效，且要求项目中所有类都已被收录进 classmap（即不能存在“未声明但实际存在的类文件”）。常见踩坑点：

• 启用了 --classmap-authoritative，但某包通过 files 加载的函数文件里动态 require 了未声明的类 —— 运行时报 Class not found
• 开发中新增了类但没重新运行 composer dump-autoload（带该 flag）—— 类不可见
• autoload-dev 中的测试类默认不进 classmap，除非显式加到 autoload.classmap 或使用 --optimize-autoloader --classmap-authoritative 并确保 dev 类也被扫描

生产环境推荐的完整命令组合

单独用 --classmap-authoritative 效果有限，必须配合 --optimize-autoloader（简称 -o）才能生成完整 classmap。典型部署命令：

WebChat Voice Proxy

⚠️ 已弃用 — 该技能已拆分为两个独立技能，以提升模块化程度：**webchat-https-proxy**（HTTPS/WSS 反向代理）和 **webchat-voi...**

下载

composer install --no-dev --optimize-autoloader --classmap-authoritative

注意：--no-dev 必须前置，否则 dev autoload 规则仍可能被加载并干扰权威性；--optimize-autoloader 是生成 classmap 的前提，没有它，--classmap-authoritative 实际无作用。

它不适合哪些场景

以下情况不应启用：

• 使用了插件或脚本在运行时动态生成类（如 Doctrine Proxy、Laravel Octane 的热重载）
• 项目依赖某些通过 include/require 手动加载的“非标准类文件”，且未在 autoload.classmap 中声明路径
• CI/CD 流程中未清理旧 vendor/ 就直接运行 install —— 可能残留旧 classmap 导致类找不到

classmap 的权威性是把双刃剑：快，但彻底放弃灵活性。一旦启用，就等于告诉 autoloader：“你别猜了，就按这张表找”。表错了，就真找不到了。