Composer 2.x 默认不生成 autoload_classmap.php，仅当配置 classmap 或使用 --optimize-autoloader 时，在 vendor/composer/autoload_classmap.php 生成；它加速类查找但需权衡维护成本。
Composer 不再生成 autoload_classmap.php，这是 2.0+ 版本的默认行为——它已彻底移除该文件，改用更高效的 vendor/composer/autoload_classmap.php（注意路径）作为类映射缓存，且仅在启用 classmap 类型自动加载时才存在。
为什么找不到 autoload_classmap.php？
Composer 2.x 默认关闭了 classmap 的全量扫描（即不主动为所有包生成类映射），除非你在 composer.json 中显式配置了 "classmap" 字段，或运行了带 --classmap-authoritative 或 --optimize-autoloader 的命令。
-
autoload_classmap.php不是独立文件，正确路径是vendor/composer/autoload_classmap.php - 该文件只在执行
composer dump-autoload --optimize-autoloader后生成（且项目中存在classmap配置或依赖含classmap） - 纯 PSR-4 自动加载项目（无
classmap）即使加--optimize-autoloader也不会生成该文件
如何强制生成并使用 classmap 缓存？
适用于含大量散列小文件（如 Laravel 的 app/Http/Controllers/ 下几十个控制器）、或需极致启动性能的 CLI 场景。核心是让 Composer 扫描指定目录并写入映射表。
- 在
composer.json的"autoload"或"autoload-dev"中添加"classmap"数组：
{
"autoload": {
"psr-4": { "App\": "app/" },
"classmap": ["app/Models/", "app/Services/"]
}
}
- 运行：
composer dump-autoload --optimize-autoloader --no-dev - 检查是否生成：
ls vendor/composer/autoload_classmap.php - 此时
ClassLoader::findFile()会优先查这个数组，跳过 PSR-4 的目录遍历
--classmap-authoritative 和 --optimize-autoloader 的区别
两者都影响 autoload_classmap.php，但作用层级不同：
立即学习“PHP免费学习笔记（深入）”；
-
--optimize-autoloader：生成autoload_classmap.php（若有 classmap 配置），并把 PSR-4 映射也预计算成数组 → 加速查找，但仍允许运行时 fallback 到文件系统（比如开发中新增类未重跑 dump） -
--classmap-authoritative：**必须配合--optimize-autoloader使用**；它声明“类只可能在 classmap 中”，一旦没命中就直接抛错，不再尝试 PSR-4 文件查找 → 性能更高，但破坏热加载，仅适合生产环境打包后固化 - 常见误用：
composer install --optimize-autoloader不会触发 classmap 扫描，必须用dump-autoload
autoload_classmap.php 生成慢？排查这三点
如果 composer dump-autoload --optimize-autoloader 卡住或耗时超 10 秒，问题通常不在 Composer 本身：
- 检查
"classmap"路径是否包含大目录（如node_modules/、vendor/或日志目录）→ 应严格限定到仅含 PHP 类的子目录 - 确认没有软链接循环或挂载 NFS 卷；classmap 扫描是同步递归 I/O，对低速存储敏感
- 某些 IDE 自动生成的临时文件（如
.php.swp、~结尾文件）会被当作 PHP 类解析 → 在classmap数组后加"exclude-from-classmap"过滤
classmap 优化是“有代价的加速”：生成一次快，但每次增删类都要重跑 dump-autoload，且文件体积随类数线性增长。真正需要它的场景其实不多，别为了“看起来快”而加。
