composer.json 中没有 autoload.exclude-from-classmap 配置项；classmap 仅扫描明确列出的路径，排除目录应通过不将其加入 classmap 或使用 autoload-dev 实现。
composer.json 中的 autoload.exclude-from-classmap 不起作用？
这个配置项根本不存在——composer.json 的标准 autoload 字段里没有 exclude-from-classmap。很多人搜到过类似写法，其实是把旧版文档、第三方插件或自定义脚本的逻辑混淆了。ClassMap 自动加载机制本身不支持“排除目录”，它只认你明确告诉它要扫描哪些路径。
"classmap" 里只写需要的目录，别把测试/工具代码混进去
ClassMap 加载靠的是 composer dump-autoload -o 扫描指定路径下所有 php 文件并生成映射表。它不会自动跳过 tests/ 或 bin/，除非你压根没把它们加进配置。
- 错误写法（把整个
src/和tests/都塞进去）：{ "autoload": { "classmap": ["src/", "tests/"] } } - 正确做法（只列生产代码路径）：
{ "autoload": { "classmap": ["src/"] } } - 如果确实有少量非标准结构的类文件在
src/下但不想被加载，就不要放那里——挪到resources/或stubs/这类不参与 autoload 的目录
想彻底屏蔽某目录？用 autoload-dev + 目录隔离
Composer 区分生产和开发依赖的自动加载规则。把测试、命令行工具、示例等代码统一放进 autoload-dev，再确保 composer install --no-dev 时这些规则不生效，是最干净的“排除”方式。
-
autoload-dev只在开发环境生效，线上部署时不会生成对应映射 - 避免在
autoload里写tests/、examples/、bin/ - 示例配置：
{ "autoload": { "psr-4": { "app\": "src/" } }, "autoload-dev": { "psr-4": { "App\Tests\": "tests/", "App\Example\": "examples/" } } }
PSR-4 加载下，“排除”本质是路径不匹配
PSR-4 是前缀映射，不是文件扫描。只要命名空间和目录结构对不上，类就根本不会被尝试加载——这本身就是最轻量级的“排除”。比如：
- 你声明
"App\": "src/"，那么只有AppFooBar对应src/Foo/Bar.php -
src/Tools/Helper.php如果没声明Tools\前缀，它永远不会被 PSR-4 加载 - 想让某个子目录完全失效？别给它配 Namespace 映射，也别把它塞进
classmap - 注意：PHP 会 fallback 到
include_path或手动require，所以真正“排除”还得靠项目结构约束，而非 autoload 配置本身
实际项目中，autoload 排除问题往往暴露的是目录职责混乱。与其纠结怎么“排除”，不如先确认：那个目录里的代码，真的该由 Composer 自动加载吗？