--classmap-authoritative并非锁定文件，而是强制Composer仅依赖classmap查表、彻底禁用PSR-4/PSR-0动态扫描；它要求所有类必须已完整录入autoload_classmap.php，否则直接报Class not found，不回退查找。
什么是 --classmap-authoritative，它真能“锁定映射”？
它不能真正“锁定”已生成的 vendor/composer/autoload_classmap.php 文件，而是告诉 Composer：**所有类都必须在 classmap 中明确登记，不再动态扫描文件系统**。一旦启用，ClassLoader::findFile() 遇到未登记的类会直接返回 null，而不是 fallback 到 PSR-0/PSR-4 的文件查找逻辑。
这意味着：如果某个包依赖 autoloading 机制（比如通过 files 或 PSR-4 动态加载），但它的类没被收录进 classmap（例如未执行 dump-autoload --optimize），就会触发 Class not found 错误 —— 这不是 bug，是预期行为。
什么时候必须加 --classmap-authoritative？
典型场景是生产环境部署后禁止任何自动发现逻辑，追求最小、最可预测的 autoload 行为。常见于：
- 容器镜像构建阶段，在
composer install --no-dev --optimize-autoloader后追加该 flag - CI/CD 流水线中验证 classmap 是否覆盖全部所需类（配合
--dry-run不常用，但可结合脚本校验） - 调试 autoload 性能瓶颈时，排除 PSR-4 扫描开销，确认 classmap 是否完整
注意：--classmap-authoritative 必须与 --optimize-autoloader（即 -o）一起用才生效；单独使用会被忽略。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer dump-autoload 加上它会怎样？
运行 composer dump-autoload -o --classmap-authoritative 会重新生成 autoload_classmap.php，并写入 "classmap-authoritative": true 到 vendor/composer/autoload_static.php 的配置结构中。
关键点：
- 它只影响后续
ClassLoader::loadClass()的行为，不改变已有 classmap 内容 - 如果项目里有
"autoload": {"files": ["src/helpers.php"]}，这些文件仍会被 require_once，但其中定义的类若未出现在 classmap 里，且又没被 PSR-4 覆盖，就会加载失败 - 第三方包若声明了
classmap字段（如"classmap": ["src/"]），其扫描结果会进入 classmap；但若只靠 PSR-4，就必须确保composer dump-autoload -o已完整索引到所有目录
容易踩的坑：为什么加了还报 Class not found？
这不是 flag 失效，而是 classmap 本身不全。常见原因：
- 执行
dump-autoload时，目标目录（如src/）下存在未提交的新增类文件，或 gitignore 排除了某些 .php 文件 - 包使用了动态类名拼接（如
new $className），而该类名不在 classmap 中，也没被 PSR-4 规则匹配到路径 -
composer.json中的autoload和autoload-dev混用，生产模式下autoload-dev被忽略，但相关类又被主 autoload 引用 - 某些 IDE Helper 或测试工具（如 phpstan）依赖反射扫描，它们可能绕过 Composer autoload，但错误提示看起来像 classmap 问题
验证方式很简单：检查 vendor/composer/autoload_classmap.php 是否包含目标类的完整命名空间路径映射；没有，就说明 classmap 生成阶段漏掉了它。
