exclude-from-classmap 用于从 classmap 自动加载中排除指定路径，仅对 classmap 生效，不影响 PSR-4/PSR-0；需在 autoload 中配置为相对路径数组，修改后须执行 composer dump-autoload 验证。
在 Composer 中，exclude-from-classmap 是 autoload 配置下的一个选项，用于从自动生成的类映射（classmap）中排除指定路径，防止这些目录下的类被自动加载。它**只对 classmap 类型的自动加载生效**，不影响 PSR-4/PSR-0 的命名空间映射。
什么时候需要 exclude-from-classmap？
常见于以下情况：
- 项目中混有测试代码、示例脚本或旧版遗留文件，它们有 .php 后缀但不应被生产环境加载；
- 某些第三方包自带 demo/fixture/docs 目录，而你用 classmap 方式加载整个包，想跳过其中非核心文件；
- 避免因临时调试文件（如
test.php、debug.php）意外被 classmap 扫描并尝试加载，导致解析错误或性能损耗。
如何配置 exclude-from-classmap？
在 composer.json 的 autoload 或 autoload-dev 块中添加该字段。格式为字符串数组，每个元素是相对于项目根目录的相对路径（支持通配符 *）：
{
"autoload": {
"classmap": ["src/", "lib/"],
"exclude-from-classmap": [
"src/Tests/",
"lib/legacy/*",
"examples/",
"docs/"
]
}
}
注意：
– 路径末尾加不加 / 都可以，但推荐统一加斜杠以明确表示目录；
– * 只能匹配单层目录或文件名，不支持递归（如 tests/** 不生效）；
– 排除路径必须位于已声明的 classmap 路径之内，否则无效。
验证是否生效？
运行以下命令重新生成 autoload 文件，并检查结果：
composer dump-autoload --optimize
然后打开 vendor/composer/autoload_classmap.php，搜索被排除的文件名或路径 —— 它们不应出现在该数组中。也可用 composer show --platform 或简单写个脚本 var_dump(class_exists('SomeExcludedClass')); 测试是否真没被加载。
常见误区提醒
– exclude-from-classmap 对 PSR-4 自动加载完全无效。PSR-4 靠命名空间和目录映射查找文件，不依赖 classmap；
– 它不能阻止文件被 require/include 手动加载，只是不让 Composer 在 classmap 中记录；
– 如果你用的是 "autoload": {"psr-4": {...}} 且没配 classmap，这个配置就不起作用；
– 修改后务必运行 composer dump-autoload（或安装/更新时自动触发），否则不会生效。
基本上就这些。合理使用 exclude-from-classmap 能让 classmap 更干净、加载更安全，尤其适合维护老项目或集成外部库时做精细控制。
