--classmap-authoritative 强制 Composer 仅依赖 classmap 加载类，禁用 PSR-4/PSR-0 回退机制，解决性能开销与 classmap 不完整导致的隐式加载风险；需配合 --optimize-autoloader 使用以确保所有类被扫描入 classmap。
--classmap-authoritative 选项告诉 Composer 在运行时完全依赖生成的 classmap，不再尝试自动加载未被 classmap 覆盖的类。它不是“让 classmap 更准确”，而是强制关闭 PSR-0/PSR-4 自动加载回退机制。
它解决什么问题？
默认情况下，Composer 会先查 classmap（比如生成自 files 或 classmap 配置），没找到就按 PSR-4/PSR-0 规则去文件系统中找对应文件。这种“双重查找”带来两个隐患：
- 性能开销：每次类未命中 classmap，就得做一次文件路径拼接 +
file_exists()检查（尤其在大量未被 classmap 覆盖的类场景下） - 不确定性风险：如果某类本该被 classmap 包含但因配置遗漏或生成疏忽没进去，它仍可能被 PSR-4 加载成功——这掩盖了 classmap 不完整的问题，上线后一旦启用
--classmap-authoritative就直接报Class not found
它怎么生效？
启用该选项后，Composer 的自动加载器会：
- 只查
vendor/composer/autoload_classmap.php中的映射表 - 对任何未出现在该数组中的类名，直接返回
false，不执行 PSR-4/PSR-0 的路径推导和文件探测 - 这意味着：所有要使用的类，必须在
dump-autoload时被明确收录进 classmap
典型使用方式：composer dump-autoload --classmap-authoritative（常配合 --optimize-autoloader 使用）。
哪些类会被放进 classmap？
不是所有类都会自动进入 classmap。只有满足以下任一条件的才会被扫描并记录：
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 在
composer.json的"autoload": {"classmap": [...]}中显式列出的目录或文件 - 在
"autoload": {"files": [...]}中声明的 PHP 文件（它们的全局函数/类也会被解析进 classmap） - 包内
composer.json启用了"classmap": ["src/", "lib/"]等配置（如 Laravel、Symfony 的部分组件）
PSR-4 声明的命名空间（如 "App\": "app/"）本身不会触发 classmap 扫描——除非你额外把它加到 classmap 数组里，或者用 --optimize-autoloader 让 Composer 主动扫描 PSR-4 目录生成 classmap（这是关键前提！）。
生产环境推荐用法
最佳实践是组合使用：
composer install --no-dev --optimize-autoloader --classmap-authoritative
其中 --optimize-autoloader 会主动扫描所有 PSR-4/PSR-0 目录，把能找到的类全写进 autoload_classmap.php；--classmap-authoritative 则确保运行时不走回头路。两者结合，既提升加载速度（免文件探测），又保证行为确定（无隐式 fallback）。
注意：启用后务必验证——启动应用、跑关键测试、触发各类功能路径，确保没有漏掉的类。CI 流程中可加入 php -d display_errors=1 -r "new SomeMissingClass();" 类似探测，提前暴露问题。
