求PHP项目用PHPUnit生成代码覆盖率文件的正确命令，无测试能否生成？

一、排查phpunit --coverage-text=<file>命令失效的原因 #

你遇到的命令无法运行，大概率是这几个常见问题导致的，你可以逐一检查：

• XDebug配置未正确开启覆盖率模式：如果你用的是XDebug 3.x，必须在php.ini里设置xdebug.mode=coverage（旧版XDebug 2.x则是xdebug.enable=1 + xdebug.coverage_enable=1）。可以通过执行php -v查看XDebug是否加载，或者用php -i | grep xdebug.mode确认coverage模式是否开启。
• 缺少PHPUnit配置文件，导致无法识别源代码：如果项目里没有phpunit.xml或phpunit.xml.dist，PHPUnit不知道要分析哪些文件。你可以先执行phpunit --generate-configuration生成默认配置，然后在配置文件中添加<filter>节点指定你的源码目录，比如：

  <filter>
      <whitelist processUncoveredFilesFromWhitelist="true">
          <directory suffix=".php">./src</directory> <!-- 替换成你的实际源码路径 -->
      </whitelist>
  </filter>
  

• 命令格式错误：命令里的<file>是占位符，实际使用时要替换成真实路径，并且去掉尖括号。比如生成到当前目录的coverage.txt文件，正确命令是：

  phpunit --coverage-text=./coverage.txt
  

• PHPUnit版本兼容性问题：不同版本的PHPUnit对覆盖率参数的支持可能有差异，你可以执行phpunit --help查看当前版本的--coverage-text参数说明，确认用法是否正确。

二、无测试用例时能否生成覆盖率报告？ #

可以生成，但报告里的代码覆盖率会是0%——毕竟没有任何测试用例执行过你的源代码。不过有个前提：
你必须通过PHPUnit配置文件指定要分析的源代码目录（就是上面提到的<filter>配置），否则PHPUnit找不到要扫描的文件，可能无法生成有效报告。这种0%覆盖率的报告虽然没有测试价值，但可以用来验证覆盖率工具的配置是否正常，比如确认报告能正确列出所有需要覆盖的文件。

内容的提问来源于stack exchange，提问作者UrmLmn