classmap通过正则扫描PHP文件提取class/interface/trait后标识符生成，不解析语法；生成的autoload_classmap.php为纯映射数组，键为完整类名，值为绝对路径，运行时直接查表加载。
classmap 是怎么生成的：正则扫描而非语法解析
Composer 的 classmap 不会真正“解析 PHP 代码”，它只是对每个 .php 或 .inc 文件做字符串级正则匹配，查找 class、interface、trait 关键字后紧跟的标识符。这意味着：
- 只要文件里有类似
class Foo {的写法，就会被提取出Foo作为类名，不管是否在命名空间内、是否重复定义、甚至是否语法合法 - 不支持注释中带类名（如
// class Bar）或跨行定义（如class Foo），因为正则只匹配单行模式 - 不会识别
final class、abstract class等修饰符，只取紧随关键字后的第一个合法标识符 - 如果一个文件定义了多个类，全部会被收录；但若类名冲突（如两个文件都定义
Helper），后扫描到的会覆盖前一个，无警告
autoload_classmap.php 文件结构与运行时加载逻辑
生成的 vendor/composer/autoload_classmap.php 是一个纯 PHP 数组返回语句，形如：
return array(
'OldUtil' => $vendorDir . '/acme/legacy/lib/OldUtil.php',
'App\Model\User' => $baseDir . '/src/Model/User.php',
'stdClass' => $vendorDir . '/some-broken-lib/stdclass.php',
);
这个数组在运行时被 Composer 的 ClassLoader::loadClass() 直接查表使用——没有路径推导、没有命名空间转换、没有 fallback。关键点：
- 键是完整类名（含命名空间，无前导
），值是绝对路径；大小写敏感，且必须完全匹配 - 一旦命中，直接
require_once对应文件，不检查该文件是否真定义了这个类 - 如果类名不在数组里，
classmap加载器就彻底跳过，交给后续注册的其他加载器（如 PSR-4）处理 - 数组本身不包含任何逻辑，所以修改它手动添加映射是可行的，但下次
composer dump-autoload会被覆盖
什么时候必须用 classmap：三类典型场景
别为了“统一”而强行用 classmap，它只在以下情况不可替代：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 项目里存在大量全局命名空间类（如
class Database { }），无法套用 PSR-4 的命名空间路径规则 - 第三方库把类分散在非标准目录（比如
lib/下混着.php、.inc、.class.php），且你不能改它的源码 - 需要确保某些类「一定被加载」，哪怕它们只被反射或
class_exists()检查调用，而不是实例化——因为classmap是全量预加载，PSR-4 是按需触发
注意：classmap 不解决循环依赖或 autoloading 阶段的类名拼写错误——它只是把「找文件」这一步提前固化，错误依然会在运行时报 Class not found。
dump-autoload --optimize 的真实作用
composer dump-autoload --optimize 并不只是“生成更快”，它做了两件事：
- 把
autoload_classmap.php中所有路径替换为绝对路径（去掉$vendorDir、$baseDir变量），避免运行时字符串拼接 - 把
autoload_psr4.php和autoload_classmap.php合并进autoload_static.php，减少文件 I/O 次数
但代价是：一旦 vendor/ 或项目根目录移动，优化后的路径就失效，必须重新 dump。开发中建议不用 --optimize，生产环境才启用。
classmap 的核心价值不在性能，而在可控性——你清楚知道每个类从哪来，也清楚它为什么没被加载。这点在排查老旧系统时比“快”重要得多。
