composer怎么排除指定的目录不加载_exclude-from-classmap用法【技巧】

_exclude-from-classmap 是非标准字段，在 composer 2.x/3.x 中完全无效；应使用根级 exclude-from-classmap 数组，值为相对路径前缀（如 “tests/”），修改后需运行 composer dump-autoload 生效。

composer.json 里怎么用 _exclude-from-classmap 排除目录

这个字段不是 Composer 官方公开支持的配置项，_exclude-from-classmap 是某些私有 fork 或旧版脚本中出现的非标准写法，在当前稳定版 Composer（2.x / 3.x）中**完全无效**。直接加到 composer.json 的 autoload 或 autoload-dev 下不会起作用，也不会报错，只是被静默忽略。

真正有效的排除方式：用 exclude-from-classmap 数组

Composer 提供了标准字段 exclude-from-classmap，它必须定义在 autoload 或 autoload-dev 同级（即根级别），值为字符串数组，每个元素是相对于项目根目录的路径前缀（支持通配符 *）。

• 只影响 PSR-0/PSR-4 自动加载生成的 classmap，不影响 require/include 手动引入
• 路径不以 / 开头，例如写 "tests/"，不要写 "/tests/"
• 匹配的是「类文件路径在 classmap 中的键名」，所以排除 "legacy/" 会跳过所有路径含 legacy/ 的类文件
• 修改后必须运行 composer dump-autoload 生效

{     "autoload": {         "psr-4": {             "app\": "src/"         }     },     "exclude-from-classmap": [         "tests/",         "legacy/*",         "scripts/"     ] }

为什么 _exclude-from-classmap 看起来“有时有效”

有些项目里看到它“生效”，其实是以下情况之一：

• 用了定制版 Composer（如某些企业内部 patch 版），硬编码支持了该字段
• 混淆了 autoload-files 和 classmap —— autoload-files 中列出的文件仍会被载入，跟 classmap 排除无关
• 误以为某目录没被自动加载是因为排除，实际是 PSR-4 命名空间没覆盖到，或文件没加 .php 后缀
• 运行了 composer install --no-autoloader 或删了 vendor/autoload.php，导致整个 autoload 失效，看起来“排除成功”

更灵活的替代方案：按需禁用 classmap 或改用 files

如果目标是彻底不让某些代码参与自动加载（比如存根、示例、临时脚本），还有两个更可控的做法：

• 把目录移出 autoload 配置范围（例如不放进 psr-4 的映射路径里），自然就不会扫描
• 用 autoload-files 显式加载必需文件，避免 classmap 扫描带来的不确定性
• 对特殊目录（如 resources/ 或 docs/）确保它们不在任何 PSR 映射路径下，且不被 classmap 模式递归包含

注意：classmap 模式默认会扫描 src/、lib/、app/ 等常见目录，如果你启用了它（例如通过 "classmap": ["src/"]），就得靠 exclude-from-classmap 精确过滤，而不是靠命名约定躲开。