composer classmap 缓存需显式启用且手动更新；适用于老项目散列文件、手动加载伪类、插件目录全扫描等psr-4无法覆盖的场景，配置在autoload/classmap下，路径相对composer.json，必须执行composer dump-autoload -o生成。
Composer 生成 classmap 缓存不是默认行为，必须显式启用；不配 classmap 或没跑 dump-autoload，就根本不会生成。
什么时候该用 classmap 而不是 PSR-4？
PSR-4 自动加载快、维护简单，但只认标准命名空间+目录结构。一旦遇到以下情况，classmap 就是唯一解：
- 老项目里有散落在任意路径的
.php文件，类名和路径完全不匹配（比如lib/utils.php里定义了CacheHelper） - 用了
include/require手动加载的“伪类”文件，又想让new CacheHelper()直接可用 - 需要把整个目录下所有 PHP 文件无条件扫进自动加载（比如插件目录
plugins/）
注意：classmap 是静态扫描结果，新增文件后必须重新运行命令，否则加载不到。
composer.json 里怎么写 classmap 配置？
在 "autoload" 或 "autoload-dev" 下加 "classmap" 字段，值是路径数组 —— 支持目录、文件、甚至通配符（但仅限于 **）：
"autoload": {
"classmap": [
"lib/",
"src/Helpers/legacy.php",
"plugins/**/init.php"
]
}
常见坑：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 路径是相对于
composer.json的，别写成绝对路径或./lib/（./会被忽略） -
**只支持一级通配，plugins/**/Helper.php合法，**/Helper.php不合法 - 如果同时写了
psr-4和classmap，优先走 PSR-4；冲突时 classmap 不会覆盖
生成和更新 classmap 缓存的关键命令
改完 composer.json 后，必须执行：
composer dump-autoload --optimize
等价于：
composer dump-autoload -o
说明：
-
--optimize才会真正生成vendor/composer/autoload_classmap.php；不加这个参数，classmap配置只是摆设 - 开发中频繁增删文件，别偷懒只跑
composer install—— 它不一定触发 classmap 重扫，必须明确跑dump-autoload -o - CI 环境里如果用了
--no-dev，记得确认autoload-dev里的classmap是否真需要，否则可能漏掉
classmap 缓存本质是一张大数组，查得快但构建成本高；路径写错、漏跑 -o、或者误以为 PSR-4 能兼容乱命名 —— 这三处卡住的人最多。
