composer dump-autoload --show 显示的是当前内存中 Composer 自动加载映射的可读快照，即已缓存的类名到文件路径的对应关系，而非实时扫描结果；它反映的是 composer.json 配置生效后、经 dump-autoload 生成的 autoload 状态。
composer dump-autoload --show 显示的到底是什么
它输出的是 Composer 当前生成的自动加载映射（autoload map），也就是 vendor/composer/autoload_classmap.php 里那个大数组的“可读快照”——不是实时扫描源码，而是展示已缓存的类名到文件路径的对应关系。
常见错误现象：composer dump-autoload --show 没反应、输出空、或没看到你刚加的类？说明该类还没被 Composer 索引进去，通常因为：
- 类文件不在
autoload配置声明的路径下（比如"psr-4": {"App\": "src/"}，但你把文件放到了lib/） -
composer.json修改后没运行composer dump-autoload（--show不会自动重生成） - 用了
classmap方式但没包含目标目录，或忘了加"optimize-autoloader": true（否则 classmap 不生效）
如何让 --show 真正反映你的类文件
关键在确保 Composer 能“看见”并收录你的类。PSR-4 和 classmap 行为差异很大：
- PSR-4：只扫描声明命名空间根目录下的
.php文件，且文件路径必须严格匹配命名空间层级（AppConsoleCommand→src/Console/Command.php或src/Console/Command/XXX.php） - classmap：会递归扫描指定目录下所有
.php文件，不校验命名空间，适合 legacy 代码；但必须显式运行composer dump-autoload -o才写入 classmap - 如果混用，
--show输出里会同时出现psr-4和classmap两块，别误以为 classmap 条目是 PSR-4 自动发现的
示例：想让 Helper.php 被 --show 列出，又不想改命名空间，就在 composer.json 加：
"autoload": {
"classmap": ["helpers/"]
}
然后运行 composer dump-autoload -o，再执行 composer dump-autoload --show 才能看到 Helper 类映射到 helpers/Helper.php。
为什么有时候 --show 输出和 vendor/composer/autoload_classmap.php 不一致
因为 --show 是从内存中当前 autoload 配置实时渲染的摘要，而 autoload_classmap.php 是上次 dump-autoload 写入的磁盘文件。两者不同步的典型场景：
- 修改了
composer.json的 autoload 配置，但只运行了composer install（它默认不重生成 autoload，除非加--no-scripts或锁文件变动） - 项目启用了
optimize-autoloader，但没加-o参数运行 dump，导致 classmap 段为空 - 使用了
autoload-dev，--show默认不显示 dev 下的映射（需加--dev）
验证是否真同步？直接对比：composer dump-autoload --show | head -20 和 head -20 vendor/composer/autoload_classmap.php。不一致就补跑一次 composer dump-autoload -o。
dump-autoload --show 在 CI 或调试时的实际用途
它不是用来“检查语法”的，而是快速确认 Composer 是否按你预期加载类——尤其当遇到 Class not found 却确定文件存在时：
- 先查
--show输出里有没有该类名（注意大小写！PSR-4 匹配区分大小写） - 没有？立刻回头检查路径、命名空间、composer.json 配置格式（逗号漏了、缩进错位都会让 autoload 段失效）
- 有，但仍报错？可能是 APCu/opcache 缓存了旧的 autoloader，或用了
require_once手动引入冲突 - CI 中建议加一行
composer dump-autoload --show | grep MyService做轻量断言，比启动整个应用更快暴露配置问题
真正容易被忽略的是：Composer 的 autoload 映射一旦生成，就不会因为文件内容变更而自动更新——删掉一个类文件，--show 里可能还留着它，直到下次 dump-autoload。
