exclude-from-classmap 仅在生成 classmap 时跳过指定路径，不影响 psr-4、autoload.files；需嵌套于 autoload 或 autoload-dev 中，且必须执行 composer dump-autoload --optimize 才生效。
exclude-from-classmap 不是用来“排除类库加载”的，它只在生成 classmap 时跳过指定文件路径，对 PSR-4、autoload.files 完全无效。真想阻止某类被加载，得从自动加载机制源头控制。
为什么 exclude-from-classmap 配了却没用
常见现象：写了 "exclude-from-classmap": ["src/Tests/"]，但 new TestsExample() 依然成功。这是因为：
- PSR-4 映射（如
"App\Tests\": "src/Tests/"）在运行时动态解析路径，根本绕过classmap，exclude-from-classmap对它零影响 - 路径大小写不一致（
"Src/Tests/"vs"src/Tests/"）或漏尾斜杠（"src/Tests"不匹配目录）会导致规则静默失效 - 没执行
composer dump-autoload --optimize，旧autoload_classmap.php还在用 - 类已被
autoload.files显式require，或被框架预加载、OPCache 缓存残留、第三方 autoloader 拦截
exclude-from-classmap 正确写法和生效前提
它必须嵌套在 autoload 或 autoload-dev 块内，且仅当项目显式声明了 classmap 类型时才起作用：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 路径是相对于
composer.json所在目录的，区分大小写，推荐加尾斜杠："src/Tests/"、"legacy/Helper.php" - 支持
*（单层通配），Composer 2.2+ 起支持**（递归），不支持正则 - 只过滤
classmap扫描结果，不影响 PSR-4 加载逻辑；若同一类同时被 PSR-4 和classmap覆盖，排除后仍可通过 PSR-4 加载 - 改完必须运行
composer dump-autoload --optimize，再检查vendor/composer/autoload_classmap.php中目标类是否已消失
想彻底不让某目录参与自动加载，别依赖 exclude
真正起效的方式是控制“谁有资格被扫描”，而不是事后过滤：
- 测试类统一挪到
tests/目录，并只在autoload-dev.psr-4中映射："App\Tests\": "tests/"，生产环境跑composer install --no-dev就不会注册该命名空间 - 废弃代码或桩文件移出所有
autoload路径（比如放resources/stubs/），确保其命名空间不匹配任何已声明前缀 - 若必须保留在
src/下，就拆开 PSR-4 映射："App\": "src/App/"+"App\Tests\": "src/Tests/"，把不想加载的子目录排除在映射之外 - 绝对不要用
autoload.files把要“排除”的类再手动require——它无条件执行，副作用不可控
排除后类还在加载？优先查硬引用和 OPcache
即使 exclude-from-classmap 生效，类仍可能被加载，原因往往不在 Composer 配置本身：
- 代码里存在
require_once 'src/Tests/Example.php'这类硬引用，完全绕过自动加载器 - OPCache 缓存了旧的
autoload_static.php或已编译的类定义，需清空 OPcache（opcache_reset()）或重启 PHP 进程 - 某些框架（如 Laravel Octane、Swoole）启用热重载后会缓存类路径，不走 Composer 默认加载流程
- 运行
composer dump-autoload -vvv观察实际扫描路径，确认排除规则是否被读取；再用php -r "var_dump(composerAutoloadClassLoader::getRegisteredLoaders());"检查当前生效的加载器类型
