classmap 是 Composer 的后备自动加载机制，用于处理不遵循 PSR-4/PSR-0 规范的老代码或散列文件；需在 composer.json 中配置 classmap 路径并执行 dump-autoload 生效，优先级低于 PSR-4，仅扫描物理路径且不自动更新。
Composer 的 classmap 不是“生成”出来的独立文件，而是通过 dump-autoload 命令把项目中符合规则的 PHP 类文件路径，写进 vendor/composer/autoload_classmap.php 里——它只是自动加载器的一个后备机制，不是替代 PSR-4 的首选方案。
什么时候该用 classmap？
它适合处理那些不遵守 PSR-4/PSR-0 命名规范的老代码、函数库、或散落在非标准目录下的类文件（比如 lib/Utils.php、src/legacy/DB.php）。Composer 会扫描你指定的路径，把每个 .php 文件里声明的类/接口/trait 全部登记进映射表。
常见错误现象：Class 'SomeLegacyClass' not found，但文件明明存在、也已加到 autoload 配置里——大概率是没跑 dump-autoload，或者路径没写对。
- 只对
"classmap"配置项里列出的路径生效，不会扫描整个src/ - 支持递归扫描子目录，但不解析 symlink（符号链接会被跳过）
- 如果同一类在多个路径下被发现，后面扫描到的会覆盖前面的（顺序取决于配置数组顺序）
composer.json 里怎么配 classmap？
直接在 autoload 或 autoload-dev 下加 "classmap" 数组，填入相对项目根目录的路径字符串或数组：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
"autoload": {
"classmap": [
"lib/",
"src/legacy/",
"functions.php"
]
}
注意点：
- 路径末尾加不加
/都行，但lib和lib/效果一致（都表示目录） - 单文件如
functions.php会被扫描，里面定义的函数不会进 classmap，但类、接口、trait 会 - 如果路径不存在，
dump-autoload不报错，但也不会收录任何东西——容易误以为“配了却没用”
为什么跑了 dump-autoload 还没生效？
最常踩的坑是：改了 composer.json 后没重新生成 autoload 文件，或者用了 --no-autoloader 之类参数绕过了这步。
- 必须显式执行：
composer dump-autoload（简写composer du） - 开发时想让 classmap 实时更新？不行。它只在 dump 时扫描一次，不监听文件变化
- 如果项目启用了优化模式（
composer install --optimize-autoloader），classmap 会被合并进autoload_files.php和autoload_static.php，此时看autoload_classmap.php可能为空——这是正常行为 - 检查是否真生效？打开
vendor/composer/autoload_classmap.php，搜你的类名，看有没有对应路径
classmap 和 PSR-4 混用要注意什么？
可以共存，但优先级低于 PSR-4。也就是说，如果一个类既匹配 PSR-4 规则，又出现在 classmap 里，Composer 会优先走 PSR-4 路径加载——classmap 只兜底。
- 不要用 classmap 去“覆盖” PSR-4 已管理的命名空间，否则可能引发类加载冲突或版本错乱
- 测试环境加了
autoload-dev.classmap，上线时忘了删？可能导致 dev-only 类被意外加载 - classmap 扫描的是物理文件路径，不关心命名空间；PSR-4 映射的是命名空间到路径。两者逻辑不同，别试图用 classmap “模拟” PSR-4 结构
真正麻烦的地方在于：classmap 一旦生成，就固化了文件路径快照。如果后续移动、重命名类文件，不重新 dump-autoload，就会加载旧路径——而这个错误往往不报错，只是静默失败或加载错版本。
