Composer包单元测试需严格隔离：require-dev与autoload-dev必须配对，autoload-dev声明测试路径（如"YourPackageTests": "tests/"），并执行composer dump-autoload；phpunit.xml.dist的bootstrap必须为vendor/autoload.php；测试类命名、目录结构须严格匹配PSR-4，且应在包自身目录下运行测试。
Composer扩展包的单元测试不是“加个phpunit就行”，核心在于隔离包自身逻辑、不依赖宿主项目，且测试入口必须能独立加载包的类。
composer.json 里 require-dev 和 autoload-dev 必须配对
只写 "phpunit/phpunit": "^9.5" 到 require-dev 不够，autoload-dev 没配会导致测试类找不到被测类。常见错误是运行 ./vendor/bin/phpunit 报 Class "YourPackageCalculator" not found。
-
autoload声明源码自动加载（如"psr-4": {"YourPackage\": "src/"}） -
autoload-dev必须声明测试代码路径（如"psr-4": {"YourPackage\Tests\": "tests/"}），否则 PHPUnit 加载测试类时无法反向解析被测类的命名空间 - 改完
composer.json后必须执行composer dump-autoload，否则新配置不生效
phpunit.xml.dist 的 bootstrap 要指向 vendor/autoload.php
不能用 src/autoload.php 或自定义引导文件——Composer 包的测试环境必须复用 Composer 自动生成的自动加载逻辑，否则 PSR-4 映射会失效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
bootstrap="vendor/autoload.php"是唯一可靠方式 - 如果包有特殊初始化逻辑（比如注册全局函数），应放在
tests/bootstrap.php中，并在phpunit.xml.dist里通过bootstrap="tests/bootstrap.php"引入，且该文件第一行必须是require_once __DIR__ . '/../vendor/autoload.php'; - 别在测试类里手动
require或include源文件，这会绕过自动加载，导致覆盖率统计失败
测试类命名和目录结构要严格匹配 PSR-4
PHPUnit 会根据测试类名反推被测类路径，一旦错位就无法运行或断言失败。例如：YourPackageTestsUnitCalculatorTest 类默认对应 YourPackageCalculator 类。
- 测试类文件必须放在
tests/Unit/下，且命名以Test结尾（如CalculatorTest.php） - 类名必须与文件名一致，且命名空间要包含
Tests子段（如namespace YourPackageTestsUnit;） - 被测类在
src/下的路径必须与命名空间完全一致（src/Calculator.php→namespace YourPackage;），否则createMock()或getMockForAbstractClass()会报错
本地开发时别直接在宿主项目里跑测试
在 Laravel 项目或普通 PHP 项目中 composer require your/package:dev-main 后，直接进 vendor/your/package 目录跑 phpunit 是最干净的验证方式。若在宿主项目根目录运行 phpunit，容易混入宿主项目的 autoloader、配置甚至数据库连接，导致测试行为失真。
- 进入包目录后，确保当前
composer.json是包自身的，不是宿主项目的 - 运行
./vendor/bin/phpunit --testdox可读性更强，失败时会显示具体哪个test*方法挂了 - CI 环境（如 GitHub Actions）应使用
cd packages/your-package && composer install && ./vendor/bin/phpunit这种显式路径，避免工作目录误判
真正容易被忽略的是：Composer 包的单元测试本质上是一次“脱离上下文”的验证——它不关心你用不用 Laravel、是否连了 Redis、有没有 .env 文件。任何试图在测试中读取宿主项目配置、调用 app() 或 config() 的写法，都已越界到集成测试范畴，应该用单独的 tests/Integration/ 目录承载。
