exclude-from-classmap用于在classmap生成时排除指定目录，提升autoload性能并避免冲突；需置于autoload或autoload-dev内，路径相对项目根目录，支持通配符。
composer.json 里用 exclude-from-classmap 排除目录
Composer 默认会扫描整个 vendor 和项目源码目录做类自动加载，但有些目录（比如测试用例、文档、遗留脚本）根本不需要参与自动加载，留着只会拖慢 composer dump-autoload 速度，还可能引发命名冲突。最直接的排除方式是在 composer.json 的 autoload 或 autoload-dev 下加 exclude-from-classmap 数组。
它只对 classmap 类型生效（包括由 psr-4 自动生成的 classmap 缓存），不影响 PSR-4/PSR-0 的命名空间映射逻辑。
-
exclude-from-classmap值是相对项目根目录的路径，支持通配符*（如"tests/*"、"docs/"） - 路径末尾加不加
/都行，但建议统一加，避免误匹配同名文件 - 排除后运行
composer dump-autoload -o，生成的vendor/composer/autoload_classmap.php里就不会再出现这些路径下的类了 - 注意：这个字段不能写在
autoload外层，必须嵌套在具体 autoload 类型块里，否则会被忽略
为什么不用 files 或 psr-4 显式声明来“绕过”？
有人想靠不声明某些目录来实现“不加载”，这是误解。只要目录被包含在 psr-4 的映射路径下（比如 "App": "src/"），Composer 就会在 dump 时全量扫描 src/ 下所有 PHP 文件——哪怕你只想要其中一部分。显式声明无法“跳过子目录”，只能靠 exclude-from-classmap 主动剔除。
-
files是手动加载单文件，和目录排除无关 -
psr-4的 value 路径一旦写宽了（如"src/"），就无法局部收窄；拆成多个映射又难维护 - 如果你的项目混着旧代码（比如
src/legacy/里全是非标准命名类），不 exclude 它，classmap会把里面所有.php文件都塞进自动加载表，哪怕它们根本不会被 new 出来
排除后仍被加载？检查是否触发了其他 autoload 机制
排除目录后发现类还在被加载，大概率不是 exclude-from-classmap 失效，而是其他路径或机制兜底了。
- 确认没在别的地方重复定义相同命名空间，比如
autoload-dev里又映射了一次"Tests\": "tests/"，而你只在autoload里排除了tests/ - 检查是否有
require或include语句硬编码加载了该目录下的文件（这种加载不走 Composer 自动加载，排除无效） - 运行
composer show --platform看是否装了全局插件，某些插件会注入额外 autoload 行为 - 用
composer dump-autoload -vvv观察输出，看 Composer 实际扫描了哪些路径，确认排除规则是否被读取
生产环境上线前务必验证 classmap 是否真的精简了
排除目录后，vendor/composer/autoload_classmap.php 文件体积变小是最直观的信号，但别只看大小——得确认关键类没被误删。
- 执行
composer dump-autoload -o && php -r "var_dump(class_exists('App\Service\Mailer'));"快速验一个核心类 - 如果用了 PHPUnit，跑一遍测试，特别注意那些依赖自动加载的 mock 类或 trait 是否还能正常解析
- CI 流程里建议加一行检查：
grep -c 'your-excluded-dir' vendor/composer/autoload_classmap.php || echo "exclusion OK" - 记住：
exclude-from-classmap不影响 PSR-4 查找逻辑，但会影响class_exists()在未加载时的判断效率（因为少扫一堆文件），这点在 CLI 命令或短生命周期脚本里容易被忽略
