phpEnv 不提供 PHPUnit，需在激活的 PHP 版本下用 Composer 安装：composer require --dev phpunit/phpunit ^10，再通过 ./vendor/bin/phpunit --version 验证；必须配置 phpunit.xml 并确保 bootstrap="vendor/autoload.php" 有效。
phpEnv 本身不提供 PHPUnit，也不能直接“安装 PHPUnit”——它只是个 PHP 版本管理工具，和 Composer、PHPUnit 没有集成关系。你真正要做的，是在 phpEnv 管理的某个 PHP 版本下，用 Composer 安装 PHPUnit。
phpEnv 环境里怎么让 PHPUnit 可用
phpEnv 只负责切换 PHP 解释器（比如 phpenv local 8.2.10），它不管扩展、依赖或测试工具。PHPUnit 是一个 Composer 包，必须在项目内或全局通过 Composer 安装。
- 先确认当前 PHP 版本已激活：
phpenv version，且php -v输出符合预期 - 确保
composer命令可用（不是php composer.phar）；若不可用，需手动下载并加入 PATH - 在项目根目录执行：
composer require --dev phpunit/phpunit ^10（PHP 8.1+ 推荐 v10，PHP 7.4–8.0 用 ^9.6） - 验证安装：
./vendor/bin/phpunit --version，看到版本号即成功
为什么不能用 phpEnv 的“软件商店”装 PHPUnit
phpEnv 的“软件商店”（如 phpenv.cn 提供的 GUI）只打包了 Apache/Nginx/MySQL/PHP 二进制，不包含 Composer 生态的 PHP 库。PHPUnit 不是系统级命令，也不编译为可执行文件，它依赖自动加载、反射和测试生命周期管理——这些只能由 Composer + PHP 运行时协作完成。
- 试图在 phpEnv 界面里找“PHPUnit 安装按钮”，会找不到
- 即使你把
phpunit.phar下载进来并丢进 PATH，也大概率因缺少autoload.php或版本冲突而报错：Class 'PHPUnit\Framework\TestCase' not found - 正确路径永远是：phpEnv → 指定 PHP → Composer → 安装 phpunit → 自动写入
vendor/autoload.php
运行测试时常见的路径和权限问题
在 phpEnv 环境下，最容易卡住的地方不是安装，而是测试执行时找不到类或配置失效。
立即学习“PHP免费学习笔记（深入）”；
-
phpunit.xml必须放在项目根目录，且bootstrap="vendor/autoload.php"路径要真实存在（别写成./vendor/autoload.php或绝对路径） - 如果用
phpenv global切换过多个 PHP 版本，记得检查composer install是在当前 PHP 版本下运行的——否则vendor/里的代码可能被错误地编译或跳过扩展检测 - Windows 用户注意：phpEnv 的 shell 脚本有时不兼容 Git Bash，推荐用 PowerShell 或 CMD 执行
./vendor/bin/phpunit，避免/路径解析失败 - 若报
Failed to load class "X"，八成是psr-4映射没配对，或composer dump-autoload没重跑
真正麻烦的从来不是“怎么装”，而是“装完之后，phpunit 调用链里哪一环断了”。每个项目都该跑一次 composer show phpunit/phpunit 和 php -m | grep xdebug（需要覆盖率时），别默认它“应该能跑”。
