github actions 中运行 composer 包的 phpunit 测试需配置正确 php 环境（如用 shivammathur/setup-php 显式启用 mbstring、xml 等扩展）、矩阵化 php 版本、验证 composer.json、避免 autoload 遗漏、区分 dev/production 加载，并集成 phpstan 与 php-cs-fixer 进行静态分析和风格检查。
GitHub Actions 里怎么跑 Composer 包的 PHPUnit 测试
Composer 包的 CI 不是配个 .github/workflows/test.yml 就完事——得让 PHP 环境、扩展、依赖版本都对得上。默认 Ubuntu runner 没装 mbstring 或 xml 扩展，phpunit 直接报错退出。
实操建议：
- 用
shivammathur/setup-php动作（比官方actions/setup-php更稳），显式声明扩展：extensions: mbstring, xml, ctype, json, openssl - PHP 版本别写死成
8.2，改用矩阵：php-version: [8.1, 8.2, 8.3]，避免某次主版本更新后 CI 突然全挂 -
composer install前加composer validate --no-check-publish，提前拦截composer.json格式错误或非法字段 - 测试命令别只写
vendor/bin/phpunit，加--no-coverage（CI 不需要生成报告）和--fail-on-warning（把 deprecation 当失败）
为什么 composer test 在本地能过，CI 却提示 “Class not found”
常见于包里用了 autoload-dev + PSR-4 映射，但 composer.json 的 autoload 段没正确定义主命名空间。CI 跑的是 composer install --no-dev（因 composer install 默认跳过 dev 依赖），导致测试类所在路径没被加载。
实操建议：
- 检查
composer.json的autoload是否覆盖了实际源码路径，比如源码在src/，就得有："autoload": { "psr-4": { "MyPackage\": "src/" } } - 开发用的测试工具（如
phpunit）放require-dev没问题，但测试用的辅助类（如tests/Support/TestCase.php）如果被autoload-dev加载，就别在生产代码里引用它 - CI 中加一步验证：
composer dump-autoload --no-dev && php -r "echo class_exists('MyPackage\Something') ? 'ok' : 'fail';"
如何让 CI 同时检查静态分析和代码风格
PHPStan 和 PHP-CS-Fixer 不是“装了就能用”。PHPStan 级别设太高（比如 level 9），会因第三方库注解不全而误报；PHP-CS-Fixer 若没配 --dry-run --diff，修复命令可能默默改文件，CI 无法感知格式问题。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
实操建议：
- PHPStan 从
level 5起步，配合--configuration=phpstan.neon，在配置里 exclude 掉vendor/和生成的 stubs - PHP-CS-Fixer 运行命令必须带
--dry-run --diff，CI 报错才代表风格不一致；fix 命令只应在 pre-commit 钩子中用 - 把它们和单元测试并列进 job：同一套 PHP 环境下串行执行，避免重复安装依赖
- 注意 PHP-CS-Fixer 版本兼容性——v3.x 不兼容 PHP 7.4，而某些 LTS 系统镜像仍默认 PHP 7.4
CI 失败时怎么快速定位是环境问题还是代码问题
错误信息里出现 Failed to clone ... permission denied 或 Could not parse version constraint ^2.0.0: Invalid version string，大概率不是你的代码错了，而是 Composer 自身行为在不同版本间有差异，或 GitHub Token 权限不足。
实操建议：
- CI 日志开头加
php -v && composer --version && echo $GITHUB_ACTIONS，确认基础环境一致 - 把
composer update拆成两步：composer update --no-interaction --prefer-dist后立刻git status，看是否意外修改了composer.lock - 私有仓库依赖？别用
auth.json明文塞 token，改用GITHUB_TOKEN注入：COMPOSER_AUTH: '{"github-oauth": {"github.com": "${{ secrets.GITHUB_TOKEN }}"}}' - 遇到奇怪的解析错误，临时在 CI 步骤里加
composer config --global repositories.packagist.org.allow_ssl_downgrade true（仅调试用，勿留生产）
最常被忽略的是 composer.lock 的生成环境——它必须由和 CI 完全一致的 Composer 主版本生成（比如 CI 用 Composer 2.5，本地就不能用 2.6），否则 autoload 文件路径、依赖解析顺序都可能出偏差。
