classmap 是 composer 的静态映射自动加载机制，适用于遗留项目、无 autoload 配置的第三方库及追求运行时极致加载速度的场景；需在 composer.json 中配置路径并执行 dump-autoload 生成 vendor/composer/autoload_classmap.php。
classmap 是什么，什么时候该用它
classmap 是 Composer 的一种自动加载机制，它不依赖命名空间或文件名约定，而是通过扫描指定路径下的所有 PHP 文件，提取其中定义的类、接口、trait，生成一张“类名 → 文件路径”的静态映射表。它适合用于：
- 遗留项目中大量使用非 PSR-0/4 规范的类（比如
class DBUtil直接写在utils/dbutil.php） - 第三方库未提供 autoload 配置，又不想手动 require
- 构建阶段可接受额外扫描开销，且运行时要求极致加载速度（因为最终是查数组，比文件系统查找快）
注意：classmap 不支持动态新增类，每次增删文件后必须重新执行 composer dump-autoload。
在 composer.json 中配置 classmap 路径
直接在 "autoload" 或 "autoload-dev" 下添加 "classmap" 字段，值为字符串数组：
{
"autoload": {
"classmap": [
"lib/",
"src/legacy/",
"utils/helpers.php"
]
}
}
说明：
- 支持目录（递归扫描所有
.php和.inc文件） - 支持具体文件（如单个函数文件或老式工具类）
- 路径是相对于
composer.json所在目录的相对路径 - 不要加尾部斜杠（虽然加了也不报错，但易混淆；
"lib"和"lib/"效果一致） - 如果路径不存在，
composer dump-autoload会静默跳过，不会报错——这点容易被忽略，建议先ls确认路径存在
执行 dump-autoload 后 classmap 存在哪
运行 composer dump-autoload（或简写 composer du）后，Composer 会：
- 扫描所有
classmap列出的路径 - 解析每个 PHP 文件中的
class、interface、trait声明（不执行代码，仅词法分析） - 将结果写入
vendor/composer/autoload_classmap.php
这个文件是一个纯 PHP 数组，形如：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
return array( 'DBUtil' => $baseDir . '/lib/dbutil.php', 'LegacyService' => $baseDir . '/src/legacy/service.php', );
关键点：
- 该文件由 Composer 自动维护，不要手动修改
- 如果你发现新类没加载，先检查这个文件里有没有对应条目，没有就说明扫描失败（路径错 / 文件没被识别 / 类名拼写错误）
-
autoload_classmap.php在生产环境会被直接require，所以非常快，但也意味着它不会感知运行时文件变化
常见坑：扫描不到类？类名对不上？
class 定义必须顶格或仅缩进空格/制表符，不能被注释、条件语句包裹：
❌ if (true) { class Foo {} } → 不会被识别
✅ class Foo {} 或 <?php class Foo {}
文件里有语法错误（比如少括号），Composer 默认静默跳过该文件，不会报错提示——建议先用 php -l filename.php 检查
类名大小写必须完全匹配：如果文件里写的是 class mysql_helper，那只能用 new mysql_helper()，new MySQL_Helper() 会失败（PHP 类名不区分大小写，但 classmap 映射键是区分的）
多个文件定义同名类？Composer 只取扫描顺序中最后一个，不会警告——这会导致行为不可预测，务必避免
class 定义必须顶格或仅缩进空格/制表符，不能被注释、条件语句包裹：
❌ if (true) { class Foo {} } → 不会被识别
✅ class Foo {} 或 <?php class Foo {}
文件里有语法错误（比如少括号），Composer 默认静默跳过该文件，不会报错提示——建议先用 php -l filename.php 检查
类名大小写必须完全匹配：如果文件里写的是 class mysql_helper，那只能用 new mysql_helper()，new MySQL_Helper() 会失败（PHP 类名不区分大小写，但 classmap 映射键是区分的）
多个文件定义同名类？Composer 只取扫描顺序中最后一个，不会警告——这会导致行为不可预测，务必避免
classmap 看似简单，但它的“静默”特性会让问题藏得比较深：路径错、文件权限不对、PHP 版本不兼容导致解析失败……这些都不会打断命令执行，只会在运行时报 Class not found。调试时优先打开 vendor/composer/autoload_classmap.php 看一眼。
