引入本地Laravel包后PHPUnit测试类TestCase找不到

问题背景 #

已将本地Laravel包shaedrich/external-tests通过path仓库方式添加到主项目，在主项目phpunit.xml中配置了包的测试文件路径，但执行php artisan test时出现错误：

Fatal error: Class 'Shaedrich\ExternalTests\Tests\TestCase' not found

原因分析 #

1. 自动加载规则限制：包的autoload-dev配置仅在包自身的开发环境中生效，主项目安装包时，Composer默认不会加载包的dev级自动加载规则，因此Shaedrich\ExternalTests\Tests\TestCase无法被自动加载。
2. 依赖缺失：包的TestCase继承自Orchestra Testbench的测试基类，该类属于包的require-dev依赖，主项目并未安装此依赖。

解决方案 #

方案一：主项目手动添加测试命名空间的自动加载 #

在主项目的composer.json中，给包的测试命名空间添加autoload-dev规则：

"autoload-dev": {
    "psr-4": {
        // 保留原有规则，新增以下配置
        "Shaedrich\\ExternalTests\\Tests\\": "vendor/shaedrich/external-tests/tests/"
    }
}

执行命令刷新自动加载：

composer dump-autoload

同时需要在主项目安装包的dev依赖（仅为运行测试）：

composer require --dev orchestra/testbench:^6.0

方案二：在包内部独立运行测试（推荐） #

包本身已配置test脚本，直接进入包的目录（../external-tests）执行：

composer test

这种方式会使用包自身的依赖和自动加载规则，TestCase能正常被识别，且不会污染主项目的依赖环境。

方案三：修改包的测试基类（不推荐） #

将包的TestCase改为继承主项目的测试基类，这样主项目运行测试时能识别，但会导致包的测试与主项目强耦合，失去独立测试的能力。

内容的提问来源于stack exchange，提问作者shaedrich