Composer 没有根级 exclude-from-classmap 配置项；有效配置必须置于 autoload 或 autoload-dev 的 classmap 子结构中，且仅对 classmap 类型生效，需配合 dump-autoload 重新生成映射。
直接说结论：Composer 没有 exclude-from-classmap 这个配置项，这是常见误解；真正控制类自动加载排除行为的是 classmap 的生成逻辑和 autoload.exclude-from-classmap（注意是 autoload. 前缀）——但仅对 classmap 类型生效，且必须在 composer.json 的 autoload 或 autoload-dev 下声明。
为什么 exclude-from-classmap 不写在根级？
这个配置不是全局开关，而是 classmap 自动加载策略的子选项。如果你没定义 "classmap": ["src/"]，那 exclude-from-classmap 就完全不生效——Composer 会直接忽略它。
-
composer.json根级的exclude-from-classmap是无效的，不会报错但也不会起作用 - 它只在
"autoload": { "classmap": [...], "exclude-from-classmap": [...] }结构中被识别 - 排除路径是相对于
composer.json所在目录的，支持通配符*（如"tests/*"），但不支持**
实际怎么配置才有效？
典型场景：你用 classmap 加载 src/，但想跳过其中的 src/Tests/ 和 src/Examples/ 目录（避免测试类或示例类被误加载）。
{
"autoload": {
"classmap": ["src/"],
"exclude-from-classmap": [
"src/Tests/",
"src/Examples/",
"src/Deprecated/"
]
}
}
执行 composer dump-autoload 后，vendor/composer/autoload_classmap.php 中将不再包含这些路径下的类文件映射。
- 注意路径末尾斜杠：写成
"src/Tests"可能漏掉src/Tests.php文件，而"src/Tests/"明确排除整个目录 - 如果同时用了 PSR-4，
exclude-from-classmap对 PSR-4 规则无影响——PSR-4 靠命名空间前缀和目录绑定，不走 classmap 查找 - 修改后务必重新运行
composer dump-autoload -o（加-o强制优化），否则可能读取旧缓存
常见错误现象和排查点
排除失效？大概率是这几个原因：
- 把
exclude-from-classmap写在了autoload-dev里，但你的类实际由autoload的classmap加载（两个 autoload 区块互不影响） - 路径大小写不一致（尤其在 Windows/macOS 开发、Linux 部署时），比如写了
"src/tests/"但实际目录是Tests - 类文件已被其他 autoload 方式覆盖：例如某个类既在
classmap扫描范围内，又通过 PSR-4 映射到了同一命名空间——这时排除 classmap 并不影响加载，因为 PSR-4 仍会生效 - 使用了
composer install而非dump-autoload：install 默认复用已生成的 autoloader，不会重新解析 exclude 规则
最易被忽略的一点：这个机制只影响 classmap 的静态扫描结果，不改变运行时行为，也不阻止文件被其他方式（如手动 require）加载。真要彻底隔离某些代码，得靠目录结构设计 + autoload 类型选型，而不是单靠 exclude。
