composer dump-autoload 不会清理无用类映射，因其仅按配置路径扫描所有 .php 文件生成 classmap，不分析引用关系；真正清理需删除文件或配置 exclude-from-classmap 后重新生成。
直接运行 composer dump-autoload 不会清理无用的自动加载映射，它只是重新生成整个 autoload.php 和相关映射文件（如 vendor/composer/autoload_classmap.php），哪怕某些类已删除或未被引用，只要仍存在于扫描路径中，就会继续留在映射里。
为什么 dump-autoload 无法“清理”无用类映射
Composer 的自动加载映射是基于文件系统扫描生成的（尤其是 classmap 类型），不是运行时分析依赖关系。只要 composer.json 中配置了 "classmap": ["src/", "lib/"] 这类路径，dump-autoload 就会递归扫描这些目录下所有符合 .php 后缀的文件，并把其中声明的类全部写入映射 —— 不管这些类是否被其他代码引用、是否已被废弃、甚至是否语法错误。
- 它不执行 PHP 解析，也不做 AST 分析或依赖追踪
- 它不读取
use语句或new表达式来判断“哪些类实际被用到” - 所谓“清理”，只能靠人工删文件 + 重新 dump，或改配置排除路径
如何真正减少 classmap 中的无用条目
目标是让 composer dump-autoload 扫描更少、生成更精简的映射。关键在调整 composer.json 的 autoload.classmap 配置：
- 不要把整个
src/目录扔进去，只列明确需要 classmap 加载的子目录或文件（例如遗留的函数库、无命名空间的类） - 用
exclude-from-classmap主动屏蔽已知废弃路径：{ "autoload": { "classmap": ["src/"], "exclude-from-classmap": ["src/Deprecated/", "src/Tests/Helper/"] } } - 确认是否真需要
classmap：现代 PSR-4 自动加载更高效且无需扫描；仅当存在全局函数、无命名空间类、或需支持 PHP 5.3–5.5 时才保留 classmap
验证 classmap 是否包含预期外的类
生成后检查 vendor/composer/autoload_classmap.php 文件内容，搜索明显不该存在的类名（如 TestHelper、LegacyUtil）。也可以用命令快速列出映射总数和示例项：
php -r "\$m = include 'vendor/composer/autoload_classmap.php'; echo count(\$m).\"\\n\"; print_r(array_slice(\$m, 0, 3));"
若发现大量测试类、临时脚本、IDE 自动生成的存根文件出现在映射中，说明 classmap 路径太宽或缺少 exclude-from-classmap。
替代方案：用 --optimize 或 --classmap-authoritative
这两个选项不减少映射条目数量，但能改变运行时行为，间接缓解“无用类被加载”的副作用：
-
composer dump-autoload --optimize：合并所有映射到单个数组，跳过文件存在性检查，提升性能；但废弃类仍在内存中 -
composer dump-autoload --classmap-authoritative：强制所有类必须出现在 classmap 中，PSR-4 回退失效 —— 这反而要求你更严格控制 classmap 内容，否则会报Class not found - 两者可共用：
composer dump-autoload --optimize --classmap-authoritative
真正“清理”的动作始终是：删源码文件 → 更新 exclude-from-classmap → 再 dump-autoload。没有一键清理命令，因为 Composer 不认为“未被引用的类”是问题 —— 它只保证“能加载”，不管“该不该存在”。
