Composer install 后无法自动触发 PHPUnit 测试，因 Composer 无内置测试钩子；需通过 scripts 配置 post-install-cmd 实现，推荐 "@php vendor/bin/phpunit --no-coverage" 并在 CI/Docker 中显式调用。
Composer install 后自动触发 PHPUnit 测试的可行路径
直接在 composer install 或 composer update 完成后运行 PHPUnit，**不能靠 Composer 自身机制“保证执行”**——它没有内置测试钩子。所谓“即时”，本质是用脚本衔接流程，而非魔法开关。
使用 scripts 配置实现 install 后自动跑 test
Composer 的 scripts 支持在生命周期事件（如 post-install-cmd）中执行命令，这是最轻量、最常用的方式。但要注意：它只在本地执行，不参与 CI 环境默认流程，且失败不会中断安装（除非显式配置）。
-
"post-install-cmd": ["phpunit --no-coverage"]是常见写法，但需确保phpunit在 PATH 中或使用vendor/bin/phpunit - 推荐写成
"post-install-cmd": ["@php vendor/bin/phpunit --no-coverage"]，避免因系统 PATH 不一致导致找不到二进制文件 - 若测试失败，默认仍会返回 0（成功），需加
--fail-on-warning和检查退出码；更稳妥的是用 shell 包裹："post-install-cmd": ["sh -c 'vendor/bin/phpunit || exit 1'"] - 该脚本仅在
composer install时触发，composer update触发的是post-update-cmd，需单独配置
vendor/bin/phpunit 找不到或报错 Class not found
这不是 PHPUnit 本身的问题，而是 autoloader 未就绪或加载顺序不对。Composer 安装刚完成时，vendor/autoload.php 已生成，但 PHPUnit 的 bootstrap 可能依赖尚未完全初始化的类（比如自定义 TestCase 或测试专用服务）。
- 确认
phpunit.xml中的bootstrap指向正确路径，例如bootstrap="vendor/autoload.php"，不要写成相对路径如../vendor/autoload.php - 若项目用了 PSR-4 自动加载，确保
tests/目录未被autoload-dev排除，且命名空间与目录结构严格匹配 - 常见错误信息
Class 'TestsTestCase' not found，往往是因为Tests\命名空间没在autoload-dev里声明，或文件后缀不是.php - 临时调试可加
-v参数看加载了哪些文件：vendor/bin/phpunit -v tests/ExampleTest.php
CI 环境下别依赖 post-install-cmd
GitHub Actions、GitLab CI 等环境通常跳过 composer install --no-interaction 的交互式脚本钩子，或因缓存机制导致 post-install-cmd 被跳过。这时候硬编码在 scripts 里等于失效。
立即学习“PHP免费学习笔记（深入）”；
- CI 配置中应显式调用：
composer install && vendor/bin/phpunit，而不是指望 hook - 若用 Docker 构建镜像，
post-install-cmd可能因多阶段构建顺序问题被忽略，建议把测试命令放在 final stage 的 entrypoint 或 CMD 中 - 本地开发用 scripts 提升体验没问题，但交付物（如 CI yaml、Dockerfile）必须把测试作为独立步骤显式写出
真正容易被忽略的是：post-install-cmd 在全局安装（composer global install）时完全不生效，且 Windows 下 cmd 解析 shell 命令的能力有限，sh -c 类写法要慎用。
