autoload-dev 中路径必须指向含 class/interface/function 声明的实际 PHP 文件或目录，如 "psr-4": {"Tests\": "tests/"} 要求 tests/ExampleTest.php 以 namespace Tests; 开头，且修改后须执行 composer dump-autoload 才生效。
autoload-dev 里写什么路径才生效
必须是实际存在的 PHP 文件路径，且文件内需有 class、interface 或 function 声明（不能只是纯逻辑代码）。Composer 只扫描这些声明并生成映射，不执行文件。
常见错误是把测试入口脚本（如 tests/bootstrap.php）直接写进 autoload-dev ——它没类声明，不会被加载，也起不到引导作用。
- 推荐写法：
"autoload-dev": { "psr-4": { "Tests\": "tests/" } }，然后在tests/下放TestsTestCase.php - 如果用
classmap，路径必须指向具体文件或含类的目录，例如"classmap": ["tests/Support/"] - 避免写
"files": ["tests/helpers.php"]来加载函数——它会在每次 Composer 自动加载时无条件执行，容易引发重复定义或依赖未就绪问题
为什么 phpunit 运行时报 Class not found
最常见原因是命名空间与目录结构不匹配，或没运行 composer dump-autoload。Composer 的 autoload-dev 配置不会自动热更新。
- 检查
tests/下文件的命名空间是否和autoload-dev.psrs-4键值对一致，比如"Tests\": "tests/"要求tests/ExampleTest.php以namespace Tests;开头 - 修改
composer.json后必须手动执行composer dump-autoload，否则新规则不生效 - 运行
composer show -s可查看当前已启用的 autoload-dev 映射，确认你的路径是否出现在列表中
autoload-dev 和 autoload 混用要注意什么
两者互不影响，但逻辑上要清晰：autoload 是生产环境可用的类，autoload-dev 是仅测试期需要的（如测试基类、Mock 工具、断言封装）。一旦误把 dev 类放进 autoload，就会导致线上部署体积变大、甚至引入安全风险。
- 不要把
Tests\放进autoload.ps4，否则用户安装你包时也会加载测试类 - 若需共享某些工具类（如数据构造器），应单独抽成
src/Support/Testing/并放入autoload，而非塞进autoload-dev -
autoload-dev中的files项在composer install --no-dev时会被跳过，但classmap和psr-4的映射仍会生成（只是对应文件不被复制）——这点容易被忽略
如何验证 autoload-dev 是否按预期工作
最直接的方式是用 Composer 内置的加载器查表，而不是靠跑测试来“间接验证”。
- 执行
composer dump-autoload -o（优化模式），再运行composer show -s | grep Tests，看是否有对应映射行 - 临时加一段调试代码：
var_dump(class_exists('TestsTestCase'));，在 CLI 环境下运行，结果为true才算成功 - 注意：IDE（如 PHPStorm）可能缓存旧的 autoload 映射，改完配置后建议重启索引或清空 cache
实际项目中，最容易出问题的是路径拼写错误、命名空间大小写不一致（尤其在 macOS 上不敏感但 Linux 会报错），以及忘记 dump-autoload。别依赖“应该可以”，每次改完都用 class_exists() 快速验一下。
