exclude-from-classmap 仅控制 autoload.classmap 生成时跳过指定路径，不影响 psr-4 或 files 加载；需在 composer.json 的 autoload/autoload-dev 下配置相对路径模式（支持 * 和 **），修改后须执行 composer dump-autoload。
composer exclude-from-classmap 是什么作用
它不是用来“排除文件”的通用过滤器，而是专门控制 autoload.classmap 生成时跳过哪些路径——只影响自动加载映射表，不影响 autoload.files 或 PSR-4 自动加载逻辑。
常见误解是以为加了它就能让 Composer 完全忽略某个文件（比如测试类、旧版兼容代码），结果发现 vendor/autoload.php 还是能加载到，或者 composer dump-autoload 后类依然出现在 classmap 里。
怎么正确配置 exclude-from-classmap
必须写在 composer.json 的 autoload 或 autoload-dev 下，且只接受路径模式（支持 * 通配符，不支持正则）：
{
"autoload": {
"classmap": ["src/"],
"exclude-from-classmap": ["src/Tests/", "src/legacy/*"]
}
}
注意几点：
-
exclude-from-classmap只对classmap类型生效，对psr-4或files无任何影响 - 路径是相对于
composer.json所在目录的，不能写绝对路径或../ - 通配符
*只匹配单层目录名（如legacy/*不会匹配legacy/foo/bar.php），要递归排除得写legacy/**（Composer 2.2+ 支持） - 修改后必须运行
composer dump-autoload，否则不会更新vendor/composer/autoload_classmap.php
为什么 exclude-from-classmap 有时没效果
最常踩的坑是：你以为它能阻止类被加载，其实它只阻止类被“收录进 classmap”。如果那个类同时被 PSR-4 规则覆盖（比如 "App\": "src/"），那它照样能被加载——exclude-from-classmap 对 PSR-4 完全无效。
另一个典型场景是想排除测试文件却放在 src/ 下：即使加了 "src/Tests/" 到 exclude-from-classmap，只要 Tests 目录没被 PSR-4 映射，它本来就不会进 classmap；但如果你还把 Tests 加进了 autoload-dev.files，那它照样会被加载。
简单说：这个配置只管“别扫进 classmap 表”，不管“能不能加载”。真正决定加载权的是整个 autoload 配置优先级（classmap → psr-4 → files）。
替代方案：什么时候该用别的方法
如果目标是彻底不让某类参与自动加载（比如 CI 中屏蔽旧版兼容层），exclude-from-classmap 往往不是最优解：
- 想完全跳过某些目录？改用
psr-4精确声明命名空间路径，别把src/整体扔进去 - 想动态控制加载（如仅 dev 环境加载测试类）？用
autoload-dev+files，并确保生产环境不加载autoload-dev.php - 想彻底移除某些文件的解析？用
scripts+post-autoload-dump脚本删行或 patchautoload_classmap.php（不推荐，破坏可维护性）
classmap 本身已是性能优化手段，盲目排除可能反而让 autoloader 多走 PSR-4 的文件系统查找。真要过滤，先确认那个路径是不是真的被 classmap 扫到了——看 vendor/composer/autoload_classmap.php 里有没有对应条目。
