autoload-dev 是独立于 autoload 的开发专用加载规则，必须作为 composer.json 顶层字段配置，仅在启用 --dev 时生效；混用或错配将导致类无法加载且难以排查。
不是用来“补全”主 autoload 的，它是完全独立的一套加载规则，只在开发环境生效。配错位置、漏掉
参数、或和
混用命名空间，都会导致类找不到却查不出原因。
autoload-dev 必须写在
composer
.json 顶层，不能嵌套
它必须是
的一级字段，和
、
并列。拼成
、放在
里、或者缩进两层，Composer 都会直接忽略整个配置。
正确位置：
错误写法：
（被无视）
错误写法：
（大小写敏感，不识别）
验证方式：运行
后，打开
，搜索
看是否注册成功
psr-4 和 classmap 在 autoload-dev 里怎么选
是测试类的默认选择；
只适合无命名空间、结构散乱的辅助文件。混用时要注意 classmap 会优先命中，可能绕过 psr-4 规则。
用
：所有测试类必须严格匹配路径与命名空间，例如
→
，且末尾必须带反斜杠：
用
：适用于
、
这类没 namespace 或含多个函数的文件，但每次增删文件都得重跑
别混用同一目录：比如同时配置
（psr-4）和
（classmap），Helper.php 里的类即使没声明
也会被加载，且无法被其他命名空间引用
修改后不生效？90% 是忘了加 --dev 参数
默认只处理
，对
完全无感。不加
，改了等于白改。
Composer 2.9.6
Composer 2.9.6 是 PHP 生态中高效、稳定的依赖管理工具。此版本在性能与兼容性上进一步优化，改进了依赖解析算法，提升大型项目中的安装与更新速度。它支持并行下载任务，显著减少等待时间，并增强了与私有仓库及镜像源的交互稳定性。同时修复了多项命令行交互与内存使用相关的缺陷，确保在复杂依赖关系下依然可靠运行。无论是新项目初始化还是现有系统维护，Composer 2.9.6 都能为开发者提供流畅、精准的依赖管理体验。
下载
必须执行：
（推荐）或
CI/CD 中容易漏：如果部署脚本用了
，那
根本不会写入
，phpunit 必然失败
本地验证快捷方式：
，返回
才算真正生效
检查映射是否生成：
files 项要小心副作用，别放初始化逻辑
列表里的 PHP 文件会在每次加载
时被
，不是“按需加载”，而是无条件执行。
适合放纯函数定义文件，比如
里只有
不适合放
：它常含数据库连接、Mock 初始化等副作用逻辑，会被反复执行
更安全的做法：把 bootstrap 逻辑封装进一个类，再用 psr-4 加载，由测试启动器显式调用
在
时会被跳过，但 classmap 和 psr-4 映射仍会生成（只是对应文件不复制）——这点极易被忽略
最常被忽视的其实是部署环节：哪怕配置全对，只要上线命令漏了
，
的映射就会进生产环境，测试类、桩代码、调试工具全跟着打包进去——体积变大、性能下降、还可能暴露攻击面。
autoload-dev--devautoloadcomposer.jsonautoloadrequire-devautoloadDevrequire-dev"autoload-dev": { "psr-4": { "Tests\": "tests/" } }"require-dev": { "autoload-dev": { ... } }"autoloadDev": { ... }composer dump-autoload --devvendor/autoload.phpTests\psr-4classmappsr-4Tests\Unit\UserTesttests/Unit/UserTest.php"Tests\"classmaptests/bootstrap.phptests/helpers/composer dump-autoload --dev"Tests\": "tests/""tests/Helper.php"namespace Testscomposer dump-autoloadautoloadautoload-dev--devcomposer dump-autoload --devcomposer install --devcomposer install --no-devautoload-devvendor/autoload.phpvar_dump(class_exists('TestsTestCase'));truecomposer show -s | grep Testsfilesvendor/autoload.phprequire_oncetests/functions.phpfunction assertJsonContains(...)tests/bootstrap.phpfilescomposer install --no-dev--no-devautoload-dev