phpunit命令找不到的正确解决方式是使用./vendor/bin/phpunit（linux/macos）或vendor\bin\phpunit（windows）调用，因其可执行文件默认位于项目vendor/bin目录下，未加入系统path；全局安装需手动将composer global config bin-dir --absolute返回路径加入环境变量。
PHPUnit 命令找不到：检查 vendor/bin/phpunit 是否存在
Composer 安装 PHPUnit 后，可执行文件默认放在 vendor/bin/phpunit，而不是全局路径。如果运行 phpunit 报 “command not found”，大概率是因为没加 vendor/bin 到 $PATH，或误用了全局安装。
确认方式：ls -l vendor/bin/phpunit。若不存在，说明没正确安装 —— 应该用 composer require --dev phpunit/phpunit（不带 @stable 等过时写法），且项目 composer.json 中未禁用 bin-dir。
- 不要手动 symlink 或改
/usr/local/bin，易与系统其他版本冲突 - CI 环境中直接用
./vendor/bin/phpunit最稳妥，不依赖环境变量 - 本地开发想省略
./vendor/bin/，可临时加export PATH="./vendor/bin:$PATH"到 shell 配置，但别在composer.json的scripts里依赖这个
composer.json 的 scripts 怎么写才可靠
在 composer.json 里配 "test": "phpunit" 是常见错误：它依赖 shell 能 resolve phpunit，而不同机器、不同 CI runner 的 PATH 不一致。
正确做法是显式调用相对路径，并指定配置文件位置，避免隐式查找：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
"scripts": {
"test": "php ./vendor/bin/phpunit --configuration phpunit.xml"
}
-
php前缀必须加，Windows 下不加会失败（.bat/.sh 区分问题） -
--configuration参数强烈建议显式传入，否则 PHPUnit 会按顺序找phpunit.xml、phpunit.xml.dist、phpunit.json，容易误读错配置 - 如果项目根目录没有
phpunit.xml，运行时会报No configuration file found，不是静默忽略
为什么 phpunit 找不到测试文件：自动发现逻辑和 --testsuite 的坑
默认情况下，PHPUnit 会从当前目录递归扫描 *Test.php 文件，但前提是这些文件在 autoload 或 autoload-dev 里声明了对应命名空间映射，否则 class not found 错误会掩盖真实问题。
更稳的方式是在 phpunit.xml 中明确 <testsuites></testsuites>：
<testsuites><testsuite name="Unit"><directory>tests/Unit</directory></testsuite></testsuites>
- 别依赖
phpunit --testdox自动推断路径，尤其当tests/下有多个子目录时 - 如果用
composer require --dev phpunit/phpunit:^10，注意phpunit.xml格式已不支持<phpunit bootstrap="..."></phpunit>顶层属性，改用<php></php>块或--bootstrap参数 -
vendor/bin/phpunit tests/Feature/UserTest.php这种单文件执行没问题，但 CI 脚本里别硬编码路径，应统一走配置文件
PHP 版本不兼容导致 phpunit 启动就报错
Composer 安装的 PHPUnit 版本必须和当前 PHP 版本匹配。例如用 PHP 8.2 运行 phpunit/phpunit:^9 一般没问题，但 ^8 可能因废弃函数（如 create_function）直接 fatal error。
查兼容性最快方法：composer show phpunit/phpunit 看输出里的 requires php 字段；再比对 php -v 输出。
- 别在
composer.json中锁死 PHPUnit 小版本（如"^9.5.0"），容易阻塞安全更新 - 如果项目必须用老 PHP（如 7.4），但又需要新特性，优先考虑升级 PHP，而不是降级 PHPUnit —— 低版本 PHPUnit 的 bug 和扩展缺失更多
- 某些共享主机或 Docker 镜像里
phpCLI 和 Web SAPI 的 INI 配置不同，php -m | grep xdebug检查 CLI 是否真启用了调试扩展，否则--coverage会静默失败
phpunit.xml 里 <autoload></autoload> 路径写错，或者 tests/ 目录没被 autoload-dev 覆盖到 —— 这类问题不会报路径错误，只会报 Class XXXTest not found，得翻 vendor/phpunit/phpunit/src/TextUI/Command.php 里的 autoload chain 才能看出端倪。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
