必须执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，键名、type值、URL结尾斜杠缺一不可，否则静默失效；验证需输出完整JSON且含正确URL。
直接换阿里云镜像源 + 本地按 PHP 版本装对应 PHPUnit，就能跳过 90% 的下载卡顿和版本报错。
怎么确认并设置正确的国内镜像源
换源不是“试试看”，是必须做、且必须写对的三要素操作：
- 键名必须是
repo.packagist（不是repos.packagist或packagist） - type 值必须显式写
composer（漏掉就 fallback 到官方源） - URL 必须用 HTTPS 且结尾带
/：https://mirrors.aliyun.com/composer/
执行这条命令（全局生效，推荐）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否成功：
立即学习“PHP免费学习笔记（深入）”；
composer config -g repo.packagist
输出应为完整 JSON，如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或仍显示 packagist.org 都说明没生效。
为什么装 PHPUnit 必须本地安装且指定版本
全局安装 phpunit/phpunit 会导致多项目版本冲突、CI 失败、甚至 ./vendor/bin/phpunit 找不到——因为不同框架对 PHPUnit 有硬性版本要求：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- PHP 7.4 / 8.0 项目 → 装
phpunit/phpunit:^9.6 - PHP 8.1+（含 Laravel 10）→ 装
phpunit/phpunit:^10.5 - PHP 8.2+ 无强约束 → 可试
phpunit/phpunit:^11.0，但注意 v11 已移除phpunit-skelgen
执行安装命令（进项目根目录）：
composer require --dev phpunit/phpunit:^10.5
装完立刻验证：
./vendor/bin/phpunit --version
如果报 Command "phpunit" is not defined，说明没装进当前项目；如果报类型兼容错误（如 setUp(): void must be compatible），基本就是版本和 PHP 不匹配。
autoload-dev 和 phpunit.xml 配置不生效的常见原因
两个配置项写错一个，Class 'PHPUnitFrameworkTestCase' not found 就必然出现：
-
composer.json中必须有autoload-dev段，且映射正确，例如："autoload-dev": {"psr-4": {"Tests\": "tests/"}} - 改完
composer.json后，必须手动运行composer dump-autoload—— Composer 不会自动重载 -
phpunit.xml必须放在项目根目录，名字不能是phpunit.xml.dist（v10+ 默认只读phpunit.xml），内容至少包含：<phpunit bootstrap="vendor/autoload.php"> - 测试文件路径必须匹配
autoload-dev映射：比如类名TestsExampleTest，就得放在tests/ExampleTest.php
生成基础配置可省事：
./vendor/bin/phpunit --generate-configuration
换源后还是卡在 Downloading 或 Resolving dependencies？
镜像只加速元数据和 ZIP 包下载，不解决以下本地瓶颈：
-
Resolving dependencies卡住 → 检查是否启用了 Xdebug（临时禁用：php -d xdebug.mode=off $(which composer) install）或内存不足（加COMPOSER_MEMORY_LIMIT=-1） -
Downloading …卡住 → 可能是公司代理拦截或 SSL 证书问题（Windows 常见），先试composer config -g cafile /path/to/cacert.pem，或临时关 secure-http（仅限可信网络） - 依赖含 C 扩展（如
ext-redis）或需git clone的私有包 → 镜像源完全无效，得单独处理 -
composer update比install慢得多 → 日常开发优先用install（靠composer.lock），update仅用于升级依赖
最常被忽略的一点：项目级镜像配置优先级高于全局，团队协作时应进项目目录运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/，让配置随代码提交，避免环境不一致。
