autoload.exclude-from-classmap 是 Composer 中用于在生成 classmap 时跳过指定文件或目录的配置项，必须嵌套在 autoload.classmap 下且仅对 classmap 生效，路径需相对于 composer.json 目录，目录结尾须加 /，修改后需执行 composer dump-autoload -o 生效。
exclude-from-classmap 不是 Composer 的配置项，它不存在。你真正要配的是 autoload.exclude-from-classmap，属于 autoload 下的子键，只在 classmap 自动加载方式中起作用。
为什么 exclude-from-classmap 会报错或无效
直接在 composer.json 根层级写 "exclude-from-classmap" 会被 Composer 忽略——它不识别这个字段。正确位置必须嵌套在 autoload → classmap 配置内部，且仅对 classmap 类型生效（不影响 PSR-4/PSR-0）。
- 常见错误现象：
composer dump-autoload后文件仍被扫描进vendor/composer/autoload_classmap.php - 根本原因：配置位置错、类型不匹配（比如你用的是 PSR-4，却去配 classmap 的排除项）
- 注意：
exclude-from-classmap不支持通配符（如*Test.php），只接受具体路径或目录
如何正确配置 autoload.exclude-from-classmap
该配置用于告诉 Composer：在生成 classmap 时跳过某些文件或目录，减少自动加载映射体积，加快 class_exists() 等调用速度。
- 必须与
classmap同时存在，例如：{ "autoload": { "classmap": ["src/", "lib/"], "exclude-from-classmap": [ "src/Tests/", "lib/DeprecatedUtil.php", "src/Adapter/Pdo/" ] } } - 路径是相对于
composer.json所在目录的，不能以/开头 - 目录结尾需加
/，否则会被当作文件名匹配（如"src/Tests"≠"src/Tests/"） - 修改后必须运行
composer dump-autoload -o（加-o强制优化）才能更新autoload_classmap.php
什么时候该用它？哪些情况其实不该用
它只优化 classmap 生成阶段，不是运行时过滤。别指望它解决“类没找到”或“命名空间冲突”问题。
- 适合场景：
– 第三方库里混入大量非类文件（如 SQL 模板、JSON Schema、测试桩）
– 自己项目中存在已废弃但暂未删除的类目录
– 构建精简版包时想剔除 demo 或 CLI 入口类 - 不该用的场景：
– 你想隐藏测试类？改用autoload-dev+psr-4更干净
– 你用的是纯 PSR-4 加载？此配置完全不生效
– 你希望按环境动态排除？Composer 不支持条件式 classmap 排除 - 性能影响：排除 100 个文件可能让
dump-autoload快 200ms，但对运行时无任何加速——classmap 查表仍是 O(1)
最易被忽略的一点：这个配置不会影响 autoload-dev 里的 classmap，dev 下的排除要单独配在 autoload-dev 块内。漏掉这点，CI 环境跑测试时仍可能加载到你不想要的类。
