exclude-from-classmap 仅在 classmap 自动加载启用时生效，须嵌套于 autoload.classmap 下，路径相对 composer.json，需执行 composer dump-autoload -o 更新；它不阻止 PSR-4 加载或运行时引入。

exclude-from-classmap 不是全局排除开关，它只在你用了 classmap 自动加载时才起作用；纯 PSR-4 项目里配了也基本没用。

exclude-from-classmap 必须嵌套在 autoload.classmap 下

很多人把 exclude-from-classmap 直接写在 autoload 顶层，结果完全不生效。它必须和 classmap 配置共存，且只能出现在 autoload 或 autoload-dev 块内部：

{
  "autoload": {
    "classmap": ["src/", "legacy/"],
    "exclude-from-classmap": ["src/Tests/", "legacy/old_helper.php"]
  }
}

• 路径是相对于 composer.json 所在目录的，不能用 ../ 或绝对路径
• 目录路径建议加尾部 /（如 "src/Tests/"），否则可能误匹配同名文件（比如 Tests.php）
• Composer 2.2+ 支持 ** 递归通配（如 "src/Tests/**"），但老版本只认 * 单层匹配
• 改完必须运行 composer dump-autoload -o，否则 vendor/composer/autoload_classmap.php 不会更新

为什么类还在被加载？常见干扰源

排除后发现类照常能 new 出来，不是配置失效，而是其他 autoload 机制兜底了：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 该类同时被 PSR-4 映射覆盖（比如 "App\": "src/"），exclude-from-classmap 对 PSR-4 完全无效
• 测试类放在 tests/ 但又在 autoload-dev.psr-4 里声明了 "Tests\": "tests/"，那它本就该被加载
• 代码里有硬编码的 require 或 include，绕过了 Composer 自动加载
• 用了 --optimize 后，PSR-4 的类也会被“固化”进 classmap —— 此时 exclude-from-classmap 才会对这些 PSR 文件生效

想彻底不让某目录参与自动加载？别依赖 exclude-from-classmap

它只管“别扫进 classmap 表”，不管“能不能加载”。真要隔离，得靠结构设计：

• 测试、示例、文档等非生产代码，一律放进 autoload-dev，部署时加 composer install --no-dev
• 不想让某个命名空间被加载？在 autoload.psr-4 里把它映射到一个不存在的路径（如 "Legacy\": "nonexistent/"）
• 零散脚本或废弃类，别塞进 src/ 再去排除，直接挪到未被任何 autoload 规则覆盖的目录（比如 scripts/）
• vendor 里的 tests/ 目录不用手动删 —— rm -rf vendor/*/tests 下次 update 就恢复，还可能破坏校验

最容易被忽略的一点：exclude-from-classmap 只影响 classmap 生成阶段的扫描行为，对运行时加载无任何控制力。它解决的是“映射表太大”或“废弃类混入 classmap 导致冲突”的问题，不是“如何禁用某类”的通用方案。