composer如何忽略某些文件不被autoload扫描？（exclude-from-classmap示例）

exclude-from-classmap是唯一能从classmap中彻底剔除指定路径的方式，仅对”type”:”classmap”生效，需置于autoload同级，路径相对于composer.json，支持*通配符，排除发生在扫描阶段。

composer.json 里用 exclude-from-classmap 排除文件

这个配置项是唯一能从 classmap 自动加载中彻底剔除指定路径的方式。它只对 "type": "classmap" 生效，不影响 PSR-4/PSR-0 的命名空间映射逻辑。

常见错误是把它当成“全局忽略”——比如想让某个测试工具类不被加载，却往 PSR-4 下的 "autoload" 里加排除，结果完全没用。

• exclude-from-classmap 必须写在 "autoload" 或 "autoload-dev" 的同级对象里，不是子字段
• 路径是相对于 composer.json 所在目录的，支持通配符 *，但不支持 **
• 排除的是「扫描阶段」：Composer 构建 classmap 时直接跳过这些路径，不会生成对应条目

{   "autoload": {     "classmap": ["src/"]   },   "exclude-from-classmap": ["src/Tests/", "src/Helpers/Debug*"] }

为什么 files 和 psr-4 不能靠排除来控制加载

files 是强制加载列表，写了就一定会 require_once；psr-4 是运行时按命名空间+文件名动态定位，没有“排除”机制——你删了文件它自然找不到，但 Composer 不会因为你写了排除就跳过扫描。

典型误操作：在 psr-4 下试图用 exclude-from-classmap 拦截某个 src/Utils/Stub.php，结果它依然能被 new UtilsStub 实例化成功，因为 PSR-4 根本不走 classmap。

• 要阻止 PSR-4 下的文件被加载，只能删文件、改命名空间、或用自动加载器钩子拦截（不推荐）
• files 列表里的文件，哪怕被 exclude-from-classmap 覆盖，也会照常加载
• 如果你混用了 classmap 和 psr-4，且同一文件同时匹配两者，classmap 优先（因为是静态索引）

执行 composer dump-autoload 后怎么验证是否生效

最直接的办法是看生成的 vendor/composer/autoload_classmap.php 文件里还有没有目标类的映射。如果用了 exclude-from-classmap 却还在里面，说明路径写错了或者没重新 dump。

• 运行 composer dump-autoload -o（优化模式）后检查 classmap 文件，比看普通模式更清晰
• 用 composer show --platform 看不到排除效果，它只显示已加载的扩展和 PHP 配置
• 排除成功 ≠ 类不可用：如果该类还能被 new 出来，大概率是它被 PSR-4 或 files 捞进来了

容易被忽略的兼容性细节

exclude-from-classmap 是 Composer 1.10+ 才支持的字段，旧版本会静默忽略。如果你团队有人还在用 Composer 1.x 早期版本，这个配置等于不存在。

• CI 环境里 Composer 版本可能和本地不一致，建议在 composer.json 顶部加 "config": {"platform": {"composer": "2.2.0"}} 锁定最低版本（需配合 composer install --ignore-platform-reqs 慎用）
• 排除路径末尾带不带 / 行为不同："src/Tests" 会排除 src/Tests.php 文件，而 "src/Tests/" 只排除目录及其子内容
• windows 路径分隔符不用转义，写 srcTests 反而出错，统一用正斜杠即可

classmap 排除这事本身很简单，难的是理清 autoload 类型之间的边界——一不小心就以为排除了，其实只是换了个方式加载。