composer dump-autoload 不清理无用类映射，仅按配置重新生成自动加载文件；清理需手动删包或精简 autoload 配置，工具如 composer-unused 仅报告建议而非自动执行。
composer dump-autoload 本身不清理无用类映射
很多人以为 composer dump-autoload 会“智能剔除”没被代码引用的类，其实它只做一件事：按 composer.json 的 autoload 配置（psr-4、psr-0、classmap、files）重新扫描并生成 vendor/autoload.php 和 vendor/composer/autoload_*.php。它不会分析你是否真用了某个类，也不会删掉“声明了但没调用”的映射项。
比如你在 autoload.files 里写了 "src/helpers.php"，哪怕这个文件里所有函数都没被调用，它依然会被加载；又比如 psr-4 映射了 "App\": "app/"，哪怕 app/UnusedService.php 从没被 use 或 new 过，它的路径照样写进 autoload classmap。
所谓“无用类映射”得靠静态分析工具识别
composer-unused 是目前最接近“自动清理无用类映射”的方案，但它不是 Composer 内置功能，也不修改 autoload 文件——它只报告哪些包或类路径大概率没被用到。
- 它扫描
src/、app/等目录下的 PHP 文件，提取use、new、class_exists()、interface_exists()等显式引用 - 默认跳过
tests/目录，若包只在测试中使用，需加--scan-tests - 对反射加载（如
new $className）、配置驱动（如 Laravel service provider 注册字符串类名）、Polyfill 副作用（如symfony/polyfill加载即注册函数）完全无感，这些都会被误判为“无用” - 输出的是建议列表，不是执行结果；你要手动删
composer.json里的依赖，再跑composer remove触发物理清理
真正删掉无用类映射，只有两个可靠路径
“删映射”不是删除一行配置那么简单，而是要让 Composer 重建 autoload 时彻底忽略那些路径。这需要你主动干预源声明：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
删掉整个包：运行
composer remove vendor/package-name→ 它会从composer.json移除条目、删vendor/下目录、更新composer.lock、重生成 autoload —— 所有该包的类映射自然消失 -
精简 autoload 配置：比如把宽泛的
"App\": "app/"改成更精确的"App\Http\": "app/Http/"和"App\Models\": "app/Models/"，然后删掉app/Unused/目录，并从autoload.psr-4中移除对应行 - 注意：
composer dump-autoload --classmap-authoritative会强制只用 classmap 加载，此时删错映射会导致Class not found；务必先确认代码里没隐式引用
别指望 CI 或部署脚本能自动发现并清理“无用映射”
CI 流程里加 composer-unused 报告没问题，但自动执行 composer remove 极其危险——它可能删掉被配置、注解或运行时反射使用的包。真实项目里，90% 的“疑似无用”都属于这类灰区。
真正能落地的自动化，只在极少数场景成立：纯 CLI 工具库、无 DI 容器、无配置化服务注册、且所有调用都是静态可追踪的。否则，每次清理前必须人工核对 composer depends <package></package>、搜索字符串类名、检查 service provider 和 config 文件。
最容易被忽略的一点：autoload 映射本身不占运行时内存，只是个查找表；真正拖慢启动的是 require 大量未使用文件、或 classmap-authoritative 包含了整包却只用一个类——优化重点不在“删映射”，而在“删包”或“收紧 autoload 范围”。
