PHPUnit不能“瞬间准备就绪”，关键在于正确执行三步：用composer require --dev phpunit/phpunit安装、配置autoload-dev映射测试目录、在项目根目录创建phpunit.xml并设bootstrap="vendor/autoload.php"，缺一不可。
PHPUnit 能不能“瞬间准备就绪”，不取决于镜像快不快，而在于你有没有跳过最常踩的三步：装错位置、漏配 autoload-dev、没生成 phpunit.xml。用国内镜像只是省几秒下载时间，掩盖不了配置断点。
composer require --dev phpunit/phpunit 之后为什么 ./vendor/bin/phpunit 找不到？
不是镜像问题，是根本没装进当前项目。常见原因：
- 没在项目根目录执行命令——必须确保当前路径下有
composer.json - 执行了
composer require phpunit/phpunit（漏了--dev）——它会进require段，上线时多出无用包，且 CI 构建加了--no-dev就直接失败 - 装完没运行
composer install或composer update——vendor/bin/phpunit是 Composer 安装二进制脚本时生成的，只跑require不触发安装流程
验证是否真装上：ls -l vendor/bin/phpunit（Linux/macOS）或 dir vendorinphpunit（Windows），有可执行文件才算成功。
Class 'PHPUnitFrameworkTestCase' not found 的真实原因
90% 情况和镜像无关，是自动加载链断在中间：
立即学习“PHP免费学习笔记（深入）”；
-
phpunit.xml里没写bootstrap="vendor/autoload.php"——测试启动时不加载 Composer 的自动加载器 -
composer.json缺autoload-dev配置，比如没声明"Tests\": "tests/"——测试类根本不在自动加载范围内 - 改完
composer.json没手动运行composer dump-autoload——Composer 不会监听 JSON 变更，这步跳过等于白配
临时调试可以加一行：require_once 'vendor/autoload.php'; 在测试文件顶部，但正式代码里必须靠 bootstrap 和 PSR-4 解决。
phpunit.xml.dist 为什么经常被忽略？
PHPUnit 默认只认当前工作目录下的 phpunit.xml 或 phpunit.xml.dist，名字或位置错一个就完全失效：
- 文件名拼错，比如
phpunit.xml.distt或phpunit.xml.bak - 放在
tests/目录下，而不是项目根目录——它压根不会被读取 - IDE（如 PHPStorm）默认加了
--no-configuration参数，得关掉这个选项 -
<directory>tests</directory>写成<directory>./tests</directory>——路径是相对于配置文件所在位置的，./是冗余且可能出错的写法
最简验证法：./vendor/bin/phpunit --configuration phpunit.xml.dist --list-tests，能列出测试方法才说明配置生效。
镜像加速只是锦上添花，真正卡住人的永远是那几个配置硬依赖：vendor/bin/phpunit 存在、autoload-dev 映射正确、phpunit.xml.dist 在根目录且命名无误、composer dump-autoload 手动触发过。少一个，就不是“慢”，而是“根本不跑”。
