推荐按项目安装PHPUnit而非全局安装，执行composer require --dev phpunit/phpunit；运行需用vendor/bin/phpunit；配置phpunit.xml时注意bootstrap、testsuites路径及PSR-4命名空间映射；PHP与PHPUnit版本需匹配，可通过config.platform指定PHP版本避免语法错误。

直接在项目里用 Composer 安装 PHPUnit

PHPUnit 不再全局安装更安全，推荐按项目安装。执行：

composer require --dev phpunit/phpunit

即可把 PHPUnit 加入 require-dev 并下载到 vendor/。注意加 --dev，否则会进生产依赖，CI 或线上部署时可能误装。

运行 PHPUnit 时找不到命令？用 vendor/bin/phpunit

Composer 安装后，PHPUnit 可执行文件不在系统 PATH，不能直接敲 phpunit。必须用完整路径：

vendor/bin/phpunit

（Linux/macOS）或

vendor\bin\phpunit.bat

（Windows）。你也可以在 composer.json 的 scripts 里加一条：

"test": "vendor/bin/phpunit"

，之后用 composer test 启动。

phpunit.xml 配置文件里常见的坑

默认 PHPUnit 会找 phpunit.xml 或 phpunit.xml.dist。没配好就容易报 Class 'Tests\TestCase' not found 这类错误。关键配置点：

jm-jsjkxyjs02-zlm-405

使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。

下载

• bootstrap 要指向自动加载入口，比如 vendor/autoload.php
• testsuites 下的 directory 必须是真实存在的路径，且需匹配你的测试文件结构（如 tests/）
• 如果用 PSR-4 加载测试类，确保 tests/ 目录已映射到 Tests\ 命名空间，且测试文件名以 Test.php 结尾、类名以 Test 结尾

PHP 版本和 PHPUnit 版本不匹配怎么办

新版 PHPUnit 对 PHP 版本有硬性要求。例如：phpunit/phpunit:^10 要求 PHP >= 8.1，^9 要求 >= 7.3。执行 composer require --dev phpunit/phpunit 时，Composer 会按当前 PHP 版本自动选兼容版本，但有时会选错——尤其当项目用了旧 PHP 但 composer.json 没锁死 platform。解决办法是显式指定版本，或在 composer.json 加：

"config": {"platform": {"php": "8.0.28"}}

。否则可能装上高版本 PHPUnit，运行时报 ParseError: syntax error, unexpected token "string" 这类致命错误。

立即学习“PHP免费学习笔记（深入）”；