phpunit bridge 不是 phpunit 替代品，而是 symfony 提供的兼容层与增强工具，用于在旧版 phpunit 上模拟新特性、捕获弃用警告；它不提供 testcase 类或断言方法，需配合 simple-phpunit 脚本使用。
PHPUnit Bridge 不是 PHPUnit 的替代品，它只是 Symfony 提供的一套“兼容层”和“增强工具”，用来在旧版 PHPUnit（如 9.x）上模拟新特性，或在升级过程中捕获弃用警告。你不需要、也不应该用它来“安装 PHPUnit”本身。
为什么 composer require symfony/phpunit-bridge 不能代替 phpunit/phpunit
很多人看到 Bridge 就以为它是“另一个 PHPUnit”，结果装完运行 ./vendor/bin/phpunit 报错：Class 'PHPUnit\Framework\TestCase' not found——因为 Bridge 本身不提供 TestCase 类，也不带任何断言方法。
- Bridge 是个“辅助包”：它提供
simple-phpunit脚本、弃用检测器、静默错误日志、以及对 PHP 8.2+ 析构器签名等的临时适配 - 它默认会帮你下载并封装一个合适版本的
phpunit/phpunit（比如 PHP 8.1 项目自动拉^10.5），但这个动作是隐式的、受控的 - 如果你已经手动装了
phpunit/phpunit，再装 Bridge 可能导致两个 PHPUnit 版本共存，vendor/bin/phpunit指向混乱
什么时候该用 symfony/phpunit-bridge
只在以下场景中真正需要它：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 你在维护一个 Symfony 项目（尤其是 v5.4/v6.4 这类 LTS 版本），且想统一使用 Symfony 官方推荐的测试启动方式
- 你需要在 CI 中自动触发“弃用警告失败”（
--fail-on-deprecation），而原生 PHPUnit 不支持该行为 - 你正在从 PHPUnit 9 升级到 10，但业务代码里还有大量
getMock()或@expectedException，想先用 Bridge 的 polyfill 缓冲过渡 - 你希望用
./bin/phpunit（Bridge 创建的 wrapper）代替./vendor/bin/phpunit，获得更稳定的 bootstrap 和环境变量注入
正确安装和使用流程（Symfony 项目典型路径）
别直接 require symfony/phpunit-bridge 就完事——它必须配合正确的入口和配置才能生效：
- 执行
composer require --dev symfony/phpunit-bridge（注意--dev） - 运行
./vendor/bin/simple-phpunit install（首次）或./vendor/bin/simple-phpunit（后续）——它会自动下载并缓存匹配 PHP 版本的 PHPUnit - 确保项目根目录有
phpunit.xml.dist，且含bootstrap="vendor/autoload.php"；Bridge 不接管 autoload，仍依赖你自己的autoload-dev配置 - 不要删掉
vendor/bin/phpunit，但日常应改用./vendor/bin/simple-phpunit或./bin/phpunit（后者需先运行composer bin phpunit copy） - 若测试中出现
Deprecated: foo() is deprecated却没中断，检查是否漏加--fail-on-deprecation参数，或SF_DEPRECATIONS_HELPER=weak环境变量干扰了行为
最常被忽略的一点：Bridge 的 simple-phpunit 是个 shell 脚本（Linux/macOS）或批处理（Windows），它会动态生成临时 vendor 目录、设置 SYMFONY_PHPUNIT_VERSION 环境变量，并调用对应 PHPUnit 版本。一旦你手动修改过 phpunit.xml 中的 bootstrap 路径，或在 autoload-dev 里漏映射 Tests\ 命名空间，Bridge 也救不了你——它不解决 autoload 失效这类底层问题。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
