_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 精确过滤，而不是靠命名约定躲开。
