exclude-from-classmap是唯一能从classmap中彻底剔除指定路径的方式，仅对"type":"classmap"生效，需置于autoload同级，路径相对于composer.json，支持*通配符，排除发生在扫描阶段。
composer.json 里用 exclude-from-classmap 排除文件
这个配置项是唯一能从 classmap 自动加载中彻底剔除指定路径的方式。它只对 "type": "classmap" 生效，不影响 PSR-4/PSR-0 的命名空间映射逻辑。
常见错误是把它当成“全局忽略”——比如想让某个测试工具类不被加载，却往 PSR-4 下的 "autoload" 里加排除，结果完全没用。
-
exclude-from-classmap必须写在"autoload"或"autoload-dev"的同级对象里，不是子字段 - 路径是相对于
composer.json所在目录的，支持通配符*，但不支持** - 排除的是「扫描阶段」：Composer 构建 classmap 时直接跳过这些路径，不会生成对应条目
{
"autoload": {
"classmap": ["src/"]
},
"exclude-from-classmap": ["src/Tests/", "src/Helpers/Debug*"]
}
为什么 files 和 psr-4 不能靠排除来控制加载
files 是强制加载列表，写了就一定会 require_once；psr-4 是运行时按命名空间+文件名动态定位，没有“排除”机制——你删了文件它自然找不到，但 Composer 不会因为你写了排除就跳过扫描。
典型误操作：在 psr-4 下试图用 exclude-from-classmap 拦截某个 src/Utils/Stub.php，结果它依然能被 new UtilsStub 实例化成功，因为 PSR-4 根本不走 classmap。
- 要阻止 PSR-4 下的文件被加载，只能删文件、改命名空间、或用自动加载器钩子拦截（不推荐）
-
files列表里的文件，哪怕被exclude-from-classmap覆盖，也会照常加载 - 如果你混用了
classmap和psr-4，且同一文件同时匹配两者，classmap 优先（因为是静态索引）
执行 composer dump-autoload 后怎么验证是否生效
最直接的办法是看生成的 vendor/composer/autoload_classmap.php 文件里还有没有目标类的映射。如果用了 exclude-from-classmap 却还在里面，说明路径写错了或者没重新 dump。
- 运行
composer dump-autoload -o（优化模式）后检查 classmap 文件，比看普通模式更清晰 - 用
composer show --platform看不到排除效果，它只显示已加载的扩展和 PHP 配置 - 排除成功 ≠ 类不可用：如果该类还能被 new 出来，大概率是它被 PSR-4 或
files捞进来了
容易被忽略的兼容性细节
exclude-from-classmap 是 Composer 1.10+ 才支持的字段，旧版本会静默忽略。如果你团队有人还在用 Composer 1.x 早期版本，这个配置等于不存在。
- CI 环境里 Composer 版本可能和本地不一致，建议在
composer.json顶部加"config": {"platform": {"composer": "2.2.0"}}锁定最低版本（需配合composer install --ignore-platform-reqs慎用） - 排除路径末尾带不带
/行为不同："src/Tests"会排除src/Tests.php文件，而"src/Tests/"只排除目录及其子内容 - Windows 路径分隔符不用转义，写
src\Tests\反而出错，统一用正斜杠即可
classmap 排除这事本身很简单，难的是理清 autoload 类型之间的边界——一不小心就以为排除了，其实只是换了个方式加载。
