PHPUnit Windows 安装教程：从零开始，一步步搞定环境配置

目标关键词：phpunit windows 安装

如果你在 Windows 上开发 PHP 项目，测试工具 PHPUnit 基本绕不开。它能帮你自动化跑测试，快速发现代码问题，尤其适合中小型项目、框架开发、接口测试和持续集成场景。很多人第一次在 Windows 上装 PHPUnit 时，会卡在 PHP 版本、Composer、环境变量、PHP 扩展、命令找不到 这些地方。下面这篇就按最实用的方式，带你把 phpunit windows 安装 一次性弄明白。

一、先搞清楚：Windows 上安装 PHPUnit 的正确思路

在 Windows 里装 PHPUnit，常见有两种方式：

推荐方式：通过 Composer 安装
- 最稳定
- 版本管理方便
- 适合长期开发项目
- 现在绝大多数 PHP 项目都这么用
手动下载 phar 文件
- 适合临时测试
- 不依赖项目依赖管理
- 但版本控制和维护不如 Composer 方便

如果你是新手，建议直接走 Composer 安装。这是最标准的 phpunit windows 安装 方式。

二、安装前需要准备什么

在开始之前，先检查你的 Windows 电脑是否具备下面几个条件。

1. 已安装 PHP

先确保你电脑里已经装好 PHP，并且能在命令行运行。

打开 命令提示符 CMD 或 PowerShell，输入：

php -v

如果能看到类似下面的信息，说明 PHP 已经可用：

PHP 8.2.10 (cli) ...

如果提示“php 不是内部或外部命令”，说明 PHP 没有配置好环境变量，或者还没安装。

2. 已安装 Composer

Composer 是 PHP 的依赖管理工具，装 PHPUnit 基本离不开它。

检查命令：

composer -V

如果能正常显示版本号，就说明 Composer 可用了。

3. PHP 版本要兼容

不同版本的 PHPUnit 对 PHP 版本要求不一样。一般来说：

PHPUnit 9.x：适合 PHP 7.3 及以上
PHPUnit 10.x：适合 PHP 8.1 及以上
如果你的项目比较旧，要注意版本兼容，不要随便装最新版本

最稳妥的做法是先看你的项目 PHP 版本，再决定装哪个 PHPUnit 版本。

三、Windows 上安装 PHP 和 Composer 的基础配置

如果你已经有 PHP 和 Composer，可以直接跳到下一节。

1. 安装 PHP

Windows 下常见的 PHP 安装方式有：

直接下载 PHP 压缩包
使用集成环境，比如：
- XAMPP
- WampServer
- Laragon

如果你是普通开发者，Laragon 很适合 Windows，启动快、配置简单、对新手友好。

手动配置 PHP 时注意：

解压后把 PHP 所在目录加入系统环境变量 Path，例如：

C:\php

然后重新打开 CMD，再执行：

php -v

2. 安装 Composer

到 Composer 官网下载 Windows 安装程序，按提示安装即可。

安装过程中通常会让你指定 PHP 路径，比如：

C:\php\php.exe

安装成功后，验证：

composer -V

四、推荐安装方式：用 Composer 安装 PHPUnit

这是最常用、最稳定的 phpunit windows 安装 方法。

方法一：安装到项目中

进入你的 PHP 项目目录，比如：

cd D:\www\myproject

然后执行：

composer require --dev phpunit/phpunit

这条命令是什么意思？

require：安装依赖
--dev：只在开发环境使用，不参与线上正式部署
phpunit/phpunit：安装 PHPUnit

安装完成后，Composer 会把 PHPUnit 放到项目的 vendor 目录里。

方法二：指定 PHPUnit 版本

如果你知道项目需要某个版本，可以明确指定：

composer require --dev phpunit/phpunit:^9.6

或者：

composer require --dev phpunit/phpunit:^10.5

版本怎么选？

如果你用的是旧项目，优先考虑 9.6
如果你是新项目，且 PHP 8.1+，可以考虑 10.x

五、安装后怎么验证 PHPUnit 是否成功

安装完成后，进入项目目录，执行：

vendor\bin\phpunit --version

如果显示版本号，说明安装成功。

例如：

PHPUnit 10.5.20 by Sebastian Bergmann and contributors.

六、如果命令太长，怎么在 Windows 里更方便地运行

Windows 下直接输入：

vendor\bin\phpunit

会有点麻烦。你可以通过以下方式简化：

方式 1：使用 composer scripts

在 composer.json 里加上：

{
  "scripts": {
    "test": "phpunit"
  }
}

然后执行：

composer test

这样更方便。

方式 2：安装全局可执行文件

不太推荐新手一开始就搞全局安装，但如果你经常切换项目，可以了解一下。

思路是把 PHPUnit 的可执行入口配置到环境变量中，或者使用全局 Composer bin 目录。
不过在 Windows 上，项目内安装 通常比全局安装更稳。

七、手动下载 PHAR 文件的安装方法

如果你不想用 Composer，也可以直接下载 PHPUnit 的 .phar 文件。

具体步骤：

下载 phpunit.phar
放到某个目录，比如：

D:\tools\phpunit\

用命令测试：

php phpunit.phar --version

如果能显示版本号，说明可以用了。

手动方式的优点

临时使用方便
不用改项目依赖

缺点

不适合多人协作
版本更新麻烦
容易和项目依赖脱节

如果你是长期做项目开发，还是建议走 Composer。

八、Windows 上安装 PHPUnit 常见报错与解决方法

这是很多人卡住的重点。下面直接列最常见的问题。

1. 提示“php 不是内部或外部命令”

原因

PHP 没有加入环境变量，或者 CMD 没刷新。

解决方法

找到 PHP 安装目录，比如：
```
C:\php
```
把这个目录加入系统环境变量 Path
重新打开 CMD
再执行：
```
php -v
```

2. 提示“composer 不是内部或外部命令”

原因

Composer 没装好，或者环境变量没配置。

解决方法

重新安装 Composer
安装时确认 PHP 路径正确
安装后重开 CMD 再测试：
```
composer -V
```

3. 安装 PHPUnit 时提示 PHP 扩展缺失

常见报错可能包括：

ext-mbstring
ext-xml
ext-dom
ext-xmlwriter
ext-json

原因

PHP 的某些扩展没开启。

解决方法

打开 php.ini，把对应扩展开启，例如：

extension=mbstring
extension=xml
extension=dom
extension=json

然后重启终端，再执行安装命令。

4. 版本冲突，提示 PHPUnit 不兼容

原因

你的 PHP 版本和 PHPUnit 版本不匹配。

解决方法

先查 PHP 版本：

php -v

然后按版本选择合适的 PHPUnit：

PHP 7.x：优先考虑 PHPUnit 9.x
PHP 8.1+：可考虑 PHPUnit 10.x

如果项目依赖比较老，就别强行升级到最新版本。

5. `vendor\bin\phpunit` 无法执行

原因

可能是安装没成功，或者目录不在当前项目路径下。

解决方法

先确认你是在项目根目录里执行命令：

cd D:\www\myproject

然后检查是否存在：

vendor\bin\phpunit

如果没有，先重新执行：

composer require --dev phpunit/phpunit

九、建议新手直接照着做的完整安装流程

如果你是电脑小白，可以直接按下面这个顺序操作：

第一步：确认 PHP 已安装

执行：

php -v

能显示版本号再继续。

第二步：确认 Composer 已安装

执行：

composer -V

能显示版本号再继续。

第三步：进入项目目录

比如：

cd D:\www\demo

第四步：安装 PHPUnit

执行：

composer require --dev phpunit/phpunit

第五步：验证是否成功

执行：

vendor\bin\phpunit --version

看到版本号就说明安装成功。

十、一个标准的 PHPUnit 测试项目结构

安装完后，你最好顺手把测试目录建起来。

常见结构如下：

myproject/
├─ app/
├─ tests/
│  └─ ExampleTest.php
├─ vendor/
├─ composer.json
└─ phpunit.xml

示例测试文件

在 tests/ExampleTest.php 中写：

<?php
use PHPUnit\Framework\TestCase;

class ExampleTest extends TestCase
{
    public function testTrueIsTrue()
    {
        $this->assertTrue(true);
    }
}

然后运行：

vendor\bin\phpunit tests

如果测试通过，会显示绿色结果。

十一、建议配置 phpunit.xml，后面更省事

在项目根目录创建 phpunit.xml：

<?xml version="1.0" encoding="UTF-8"?>
<phpunit bootstrap="vendor/autoload.php">
    <testsuites>
        <testsuite name="Test Suite">
            <directory>tests</directory>
        </testsuite>
    </testsuites>
</phpunit>

以后你只要执行：

vendor\bin\phpunit

它就会自动去 tests 目录找测试文件。

十二、Windows 环境下的实用避坑建议

1. 不要混用多个 PHP 版本

很多人电脑里同时装了 XAMPP、Laragon、独立 PHP，结果命令行跑的是另一个版本，最后就会出现各种兼容问题。

建议只保留一个主用 PHP，并确认：

where php

看看到底命中了哪个 PHP 路径。

2. 安装完环境变量后一定要重开终端

环境变量改完后，原来的 CMD 不会自动刷新，必须重新打开。

3. 线上环境不要把 PHPUnit 带进去

PHPUnit 属于开发测试工具，部署生产环境时一般不需要保留在正式包里。
所以建议用 --dev 安装。

4. 项目升级时要同步检查 PHPUnit 版本

如果你升级了 PHP，也要检查 PHPUnit 是否还兼容，不然测试命令可能突然跑不起来。

十三、最推荐的安装方案总结

如果你现在只是想快速完成 phpunit windows 安装，直接记住这一套就够了：

安装并配置好 PHP
安装 Composer
进入项目目录
执行：

composer require --dev phpunit/phpunit

用下面命令验证：

vendor\bin\phpunit --version

这是最稳、最省心、最适合长期开发的方案。

十四、结语前的实用补充：适合不同用户的选择

新手用户

直接用 Composer 安装，不建议手动折腾 phar 和全局环境。

进阶用户

可以根据项目 PHP 版本，精确指定 PHPUnit 版本，并配置 phpunit.xml、composer scripts。

专业用户

建议结合 CI/CD 使用 PHPUnit，配合 GitHub Actions、Jenkins 或 GitLab CI 做自动测试，这样在团队开发里效率更高。

十五、快速命令汇总

查看 PHP 版本

php -v

查看 Composer 版本

composer -V

安装 PHPUnit

composer require --dev phpunit/phpunit

查看 PHPUnit 版本

vendor\bin\phpunit --version

运行测试

vendor\bin\phpunit

十六、常见问题一览

Q1：Windows 上安装 PHPUnit 必须装 Composer 吗？

不必须，但强烈建议。Composer 是最稳定的安装方式。

Q2：PHPUnit 安装后命令找不到怎么办？

先确认是不是项目目录下执行的，再检查 vendor\bin\phpunit 是否存在。

Q3：PHP 7 能不能装最新 PHPUnit？

不一定，版本要匹配。旧 PHP 一般搭配旧版 PHPUnit 更稳。

Q4：我装了 XAMPP，还需要单独装 PHP 吗？

不一定，但要确保命令行里调用的是你想用的那个 PHP。

Q5：为什么安装时总报扩展缺失？

因为 php.ini 里一些常用扩展没启用，检查 mbstring、xml、dom 等配置。

十七、最终结论

在 Windows 上安装 PHPUnit，最靠谱的路线就是：先把 PHP 和 Composer 配好，再用 Composer 在项目中安装 PHPUnit。
这样不仅安装简单，还方便后续升级、维护和团队协作。对于绝大多数开发场景来说，这就是最标准的 phpunit windows 安装 方案。