如何在Composer中文环境下运行测试？集成PHPUnit的配置指南-composer-PHP中文网

必须加--dev参数安装phpunit，phpunit.xml须置于根目录并严格命名，autoload-dev需显式映射中文路径且运行composer dump-autoload生效；否则将出现命令缺失、类找不到或配置静默失效。

如何在composer中文环境下运行测试？集成phpunit的配置指南

直接运行 ./vendor/bin/phpunit 就能跑测试，但中文环境里报错、乱码、路径不识别、类找不到——90% 不是编码问题，而是 composer.json 里没加 --dev、phpunit.xml 没放对位置、或 autoload-dev 映射漏了中文路径支持。

不加 --dev，phpunit/phpunit 会被写进 require 段，导致 composer install --no-dev（CI/上线常用）后命令直接消失，报 Command not found: phpunit。这不是 PATH 或权限问题，是依赖根本没装上。

PHPUnit 默认只读当前工作目录下的 phpunit.xml 或 phpunit.xml.dist。文件名多一个空格、少一个点、放错层级（比如丢进 tests/），它就静默退回到默认行为：只扫当前目录下 *Test.php，完全忽略你写的配置。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

文件必须放在和 composer.json 同级的根目录，不能是 tests/phpunit.xml 或 phpunit.xml.php
<phpunit></phpunit> 标签里必须有 bootstrap="vendor/autoload.php"，否则 use TestsUnitExampleTest 会报 Class not found
<directory>tests</directory> 是相对路径，以配置文件所在目录为基准；写成 ./tests 或 ../tests 多数失败
PHP 9.3+ 已废弃 <whitelist></whitelist>，覆盖率为空？改用 <coverage><include><directory>src</directory></include></coverage>

即使 phpunit.xml 正确，只要 autoload-dev 没生效，或测试类路径与命名空间不一致，就会报 Class 'TestsUnitExampleTest' not found。中文路径本身没问题，但映射必须显式声明。

composer.json 中确保有："autoload-dev": { "psr-4": { "Tests\": "tests/" } }（Windows 下反斜杠需双写）
测试文件路径必须匹配命名空间：例如 tests/Unit/用户验证Test.php → 命名空间必须是 TestsUnit，类名是 用户验证Test（PHP 允许中文类名，但需确保文件系统支持 UTF-8）
改完 composer.json 后，必须手动运行 composer dump-autoload，否则新增映射不会写入 vendor/autoload.php
如果项目根目录含中文（如 /Users/张三/my-project），确认终端当前 shell 编码为 UTF-8（Linux/macOS 可查 locale | grep UTF）

Composer 从不把 phpunit 加进系统 $PATH，它只放在项目本地的 vendor/bin/ 下。敲 phpunit 报 command not found 是正常现象——不是装失败，是路径没对上。

Linux/macOS：用 ./vendor/bin/phpunit（注意开头的 ./）
Windows CMD：用 vendorinphpunit
PowerShell：用 .endorinphpunit
想简化？在 composer.json 的 scripts 里加："test": "phpunit"，之后运行 composer test 即可
指定配置？加 -c 参数：./vendor/bin/phpunit -c phpunit.xml