classmap-authoritative 是 Composer 关闭所有类加载 fallback 机制的开关，强制仅通过 classmap 查找类；它不是 PSR-4 的加速版，而是彻底禁用命名空间路径推导，要求所有类必须预先扫描进 classmap，否则直接报错。
开启 classmap-authoritative 后，Composer 不再尝试加载未被 classmap 覆盖的类——哪怕文件真实存在、路径也对，只要没进映射表，就直接报 Class not found。这不是 bug，是设计使然。
classmap-authoritative 是什么，为什么不能只靠 PSR-4
它不是“更快的 PSR-4”，而是彻底关掉所有 fallback 查找路径的开关。PSR-4 依赖命名空间与目录结构严格对应，遇到以下情况就完全失效：
- 类定义在
config.php或functions.inc里，没命名空间 - 一个
Utils.php文件里写了class ArrayHelper和class StringHelper - 类名是
DBConnection，但文件叫mysql.php
这些必须靠 classmap 扫描登记；而 classmap-authoritative 的前提，就是你已把所有这类类都扫进去了——否则上线即炸。
怎么配 composer.json 并生成权威映射
配置本身很简单，但漏掉任一环节都会导致类找不到：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在
composer.json的"autoload"下加"classmap"数组，比如["lib/", "includes/", "legacy/"]（注意末尾斜杠表示目录） - 可选：在
"config"里加"classmap-authoritative": true，但这只是默认开关，真正生效靠命令行参数 - 必须运行
composer dump-autoload -o --classmap-authoritative（-o即--optimize-autoloader，不加它--classmap-authoritative不起作用） - 检查
vendor/composer/autoload_classmap.php，确认你要用的类名确实在数组 key 里
别信“配置完就自动生效”——dump-autoload 没跑，autoload_classmap.php 就不会更新，一切等于白配。
为什么 new 一个类报错，但 require_once 能跑
这是最常踩的坑，现象是：php -r 'new LegacyDB();' 报错，但 require_once 'legacy/DB.php'; new LegacyDB(); 正常。说明类本身没问题，问题出在加载链路上：
- 新增了类文件，但没重新执行
composer dump-autoload - 路径写成
"legacy"（缺斜杠），Composer 会当作文本文件读取失败，静默跳过该路径 - 用了
--classmap-authoritative，但LegacyDB没被扫进autoload_classmap.php，也不 fallback，直接挂 - Linux 部署时大小写不一致：类名是
LegacyDB，但文件叫legacydb.php—— Windows 可能不报错，Linux 直接找不到
生产环境部署必须注意的三件事
--classmap-authoritative 在高并发下确实能省掉每次加载时的 2~5 次 file_exists() 调用，但代价是零容错：
- Docker 构建阶段必须用
composer install --no-dev --optimize-autoloader --classmap-authoritative，CI/CD 脚本里漏掉--classmap-authoritative，线上行为就和本地不一致 - 动态类场景要格外小心：比如测试中用
eval("class TestStub {}")，或框架通过反射扫描tests/下的类——这些不会进 classmap，开了 authoritative 就直接失败 - 别把
src/这种已由 PSR-4 覆盖的目录又塞进classmap：既没收益，又拖慢dump-autoload，还增大autoload_classmap.php体积
真正的难点不在怎么开，而在确保 classmap 始终完整——尤其当项目混用新旧代码、有遗留 .inc 文件、或 CI 自动构建路径和本地不一致时，那个缺失的类名，往往藏在 autoload_classmap.php 的最后一行附近。
