classmap 是 Composer 生成的类名到文件路径的扁平映射数组，非 UML 类图；它通过扫描指定路径下的 PHP 文件提取声明，不分析继承或依赖关系，仅用于加速自动加载。
“类图模式”不是 Composer 的官方概念，你实际想问的是 classmap 优化——但直接套用这个词容易误解为 UML 类图或静态分析图，反而掩盖了真实机制。
classmap 是什么，为什么它不等于“画类图”
Composer 的 classmap 是一个纯 PHP 数组，形如 ['App\Http\Controller\Home' => '/path/to/src/Http/Controller/Home.php']，它不包含继承关系、依赖箭头或可视化结构，只是类名到文件路径的扁平映射。所谓“类图模式”是误传，真正起作用的是 composer dump-autoload -o 或 composer install --optimize-autoloader 生成的这个数组。
- 它不分析类之间的 extends/implements 关系，也不生成任何图形
- 它只扫描你声明在
composer.json的autoload.classmap或autoload.psr-4路径下的.php文件，并提取其中的class、interface、trait声明 - 文件名必须与类名严格匹配（如
Foo.php含class Foo），否则会被跳过
为什么加了 -o 反而更慢？常见错因
这不是 classmap 本身慢，而是加载方式和环境不匹配：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- PHP 7.4+ + Composer 2 默认启用
autoload_static.php，它比旧式autoload_classmap.php更轻量；dump-autoload -o在这种环境下会额外生成冗余的 classmap 文件，徒增反序列化开销 - 没配
--no-dev：测试目录（tests/）、文档（docs/）被一并扫入 classmap，体积膨胀数 MB，每次请求都要全量加载 - 启用了
--classmap-authoritative却没扫全：比如bin/下的可执行类、app/Exceptions/里的自定义异常，只要漏一条，运行时就直接Class not found，不是慢，是崩
真正有效的 classmap 用法
别追求“全量扫描”，要精准收口：
- 删掉
composer.json中无用的 autoload 条目，例如"docs/": ["docs/"]、"tests/": ["tests/"]（测试类应放在autoload-dev） - 把高频、稳定、无动态逻辑的模块显式写进
classmap："classmap": ["src/", "app/Providers/", "app/Console/Commands/"] - 生产部署固定用：
composer install --no-dev --optimize-autoloader --prefer-dist（--no-dev确保不混入测试类，--optimize-autoloader触发 PSR-4 → classmap 转换） - 验证是否生效：检查
vendor/composer/autoload_static.php是否存在且非空；再看vendor/composer/autoload_real.php中是否调用了$loader->addClassMap()
classmap 不是银弹，关键在边界控制
它对动态类名（$class = $prefix . $name; new $class();）、eval()、条件加载、class_alias() 完全无效；一旦项目里有这类逻辑，classmap 就只能覆盖部分路径，强行开启 --classmap-authoritative 会导致不可预知的 Class not found。真正省时间的地方，其实是删掉那些没人用的 autoload 配置，而不是堆参数。
