exclude-from-classmap 对测试目录无效，因为它只影响 classmap 生成，而 psr-4 加载器仍会运行时扫描 tests/；应改用 autoload-dev 隔离测试类，并部署时加 --no-dev。
为什么
对测试目录无效？
因为
只影响
生成阶段，而
默认启用的
或
自动加载器仍会扫描整个命名空间路径——包括
。哪怕你把
从
排除，
加载器在运行时遇到
开头的类名，仍会去
下找文件，触发不必要的磁盘 I/O。
真正起效的方案：用
隔离测试类加载
Composer 的设计本意就是让测试代码不参与生产环境 autoload。正确做法是把测试相关配置全挪到
，并确保生产环境（
）完全忽略它：
块里只放生产代码的
映射，比如
里放测试映射，比如
部署时务必加
参数，否则
仍会被合并进
验证是否生效：执行
后，检查
是否还包含
键
该用在哪儿？
它只对
类型有用，典型场景是排除那些“存在但不该被自动加载”的辅助脚本或遗留文件，比如：
项目根目录下零散的
、
里临时保留但已废弃的
某些命令行工具脚本，它们不是类文件，也不该被 PSR 规则匹配
写法示例（
）：
Composer 2.9.6
Composer 2.9.6 是 PHP 生态中高效、稳定的依赖管理工具。此版本在性能与兼容性上进一步优化，改进了依赖解析算法，提升大型项目中的安装与更新速度。它支持并行下载任务，显著减少等待时间，并增强了与私有仓库及镜像源的交互稳定性。同时修复了多项命令行交互与内存使用相关的缺陷，确保在复杂依赖关系下依然可靠运行。无论是新项目初始化还是现有系统维护，Composer 2.9.6 都能为开发者提供流畅、精准的依赖管理体验。
下载
容易被忽略的性能陷阱
即使用了
，如果测试目录结构混乱，仍可能拖慢
速度：
避免在
下混放大量非 PHP 文件（如截图、日志、.md 文档），
扫描时会逐个 stat，尤其在 CI 环境挂载网络存储时更明显
不要在
里用
映射到
外的任意路径，比如
—— 这会让测试类名和生产命名空间耦合，导致
失效
是单入口，只要它包含任何指向
的映射，生产环境就存在加载风险，哪怕你没主动 new 那些类
最稳妥的做法：测试代码只存在于
，且部署时强制
；其余所有“排除”手段都是补救，不是替代。
exclude-from-classmapexclude-from-classmapclassmapautoloadpsr-4psr-0tests/tests/classmappsr-4Teststests/autoload-devautoload-devcomposer install --no-devautoloadpsr-4"App\": "src/"autoload-dev"Tests\": "tests/"--no-devautoload-devvendor/autoload.phpcomposer dump-autoload --no-devvendor/composer/autoload_psr4.php"Tests\"exclude-from-classmapclassmapbootstrap.phpinstall.phpsrc/LegacyHelper.phpcomposer.json
"autoload": {
"classmap": ["src/"],
"exclude-from-classmap": ["src/LegacyHelper.php", "bootstrap.php"]
}
autoload-devcomposer dump-autoloadtests/composertests/psr-4src/"App\Tests\": "tests/"--no-devvendor/autoload.phptests/autoload-dev--no-dev