exclude-from-classmap 仅在生成 classmap 时跳过指定文件以减小映射体积，只影响 classmap 加载且需配合 --optimize 使用，对 psr-4、autoload.files 无效。
Composer 的 autoload.exclude-from-classmap 怎么用
这个配置项不是用来“排除自动加载”的，而是专门用于优化 classmap 生成过程：它告诉 Composer 在扫描目录生成类映射时跳过某些文件或模式，从而减少 vendor/composer/autoload_classmap.php 的体积和加载开销。
它只对 "classmap" 类型的自动加载生效，对 psr-4 或 psr-0 无效——那些是运行时按命名空间动态定位文件的，不依赖 classmap。
-
exclude-from-classmap必须写在autoload或autoload-dev下，值为字符串数组 - 路径是相对于
composer.json所在目录的，支持通配符*（但不支持**） - 匹配的是文件路径，不是命名空间；例如
"tests/*"会跳过整个 tests 目录下的所有文件（即使它们有合法类声明）
示例：
{
"autoload": {
"psr-4": { "App\\": "src/" },
"classmap": ["lib/"],
"exclude-from-classmap": ["lib/TestHelpers.php", "lib/legacy/*"]
}
}
为什么 autoload.files 不能靠 exclude 排除
autoload.files 是明确列出、每次请求都无条件 require 的文件列表，它不走任何发现逻辑，也没有 exclude 机制。想“排除”某个 files 条目，唯一办法是删掉它或用脚本动态生成 composer.json。
常见误操作：以为加了 exclude-from-classmap 就能阻止某个 helper 文件被加载——如果该文件已被写进 autoload.files，那它照常执行，跟 classmap 完全无关。
-
autoload.files的文件会在vendor/autoload.php中被直接require，早于所有自动加载器注册 - 若想按环境控制加载（比如只在 dev 加载调试工具），应拆到
autoload-dev.files，并确保生产环境运行composer install --no-dev - 不要试图用 classmap exclude 去“屏蔽”
files条目，方向错了
composer dump-autoload --optimize 时 exclude 生效的关键点
exclude 规则只在生成 classmap 时起作用，而 classmap 默认只在 --optimize（或旧版 --classmap-authoritative）模式下启用。普通开发模式下，Composer 默认走 PSR 映射，classmap 根本不参与加载流程。
- 运行
composer dump-autoload --optimize后，Composer 会重新扫描classmap配置目录，并应用exclude-from-classmap - 但注意：
--optimize也会把所有 PSR 映射“固化”进 classmap，此时 exclude 同样对这些 PSR 文件生效——也就是说，哪怕你写了"psr-4": {"Foo\\": "src/"}，只要src/DebugOnly.php被exclude-from-classmap匹配，它就不会出现在最终 classmap 中 - 验证是否生效？检查生成的
vendor/composer/autoload_classmap.php，搜索对应文件名看是否存在
真正想“排除自动加载”的场景，该用什么
如果你的需求本质是“某些类在生产环境不该被加载或发现”，exclude-from-classmap 不是通用解法。它只是构建期的过滤，且仅影响 classmap。更实际的控制点在运行时或结构设计：
- 把不应上线的类（如 mock、fixture、debug 工具）统一放进
tests/或dev-tools/，并通过autoload-dev管理，再配合--no-dev - 避免在
autoload.files中写入环境敏感文件；改用服务容器或工厂函数按需加载 - 使用 PHP 的
class_exists($name, $autoload = false)手动控制是否触发自动加载 - Composer 本身不提供“条件加载”或“环境感知 exclude”，这类逻辑得由项目自己承接
最易被忽略的一点：exclude 规则不会递归清理已生成的 classmap 缓存，composer dump-autoload 必须显式执行，且要确认当前命令没被 alias 或 CI 脚本绕过。
