GitHub Actions 中 composer install 报错的根本原因是工作目录错误或 composer.json 未检出；需用 actions/checkout@v4 后指定 working-directory 或 cd，启用 submodules，显式缓存 ~/.composer/cache，按阶段选择 --no-dev，并确保 PHP 版本与扩展匹配。

GitHub Actions 里 composer install 报错 “Could not find package” 或 “Your requirements could not be resolved”

根本原因不是网络或权限，而是默认工作目录没切对，或者 composer.json 根本没被检出。CI 流水线跑在干净容器里，不会自动 cd 到项目根目录，也不会保证所有文件都存在。

• 确保用 actions/checkout@v4 后加一步 cd ${{ github.workspace }}（或直接在后续步骤用 working-directory 指定）
• 检查是否启用了 submodules: true（如果依赖通过 Git 子模块引入），否则 composer install 可能找不到本地路径包
• 别信缓存插件的“自动识别”——显式声明缓存 key，比如用 ${{ hashFiles('**/composer.lock') }}，否则 lock 文件更新后仍用旧缓存，导致依赖不一致

要不要运行 composer install --no-dev 在 CI 中？

要，但得看阶段。测试环境通常需要 --no-dev，避免装一堆只用于开发的工具（比如 phpunit、larastan）污染构建产物；但如果是跑单元测试的 job，反而必须去掉这个 flag，否则 vendor/bin/phpunit 根本不存在。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 构建/打包 job：用 composer install --no-dev --optimize-autoloader，减少体积、加速 autoloader
• 测试 job：用 composer install（不带 --no-dev），并确认 composer.json 的 require-dev 已提交
• --optimize-autoloader 在 PHP 8+ 效果有限，但对 PHP 7.4 仍有明显启动提速，别省

为什么 composer install 在 GitHub Actions 中特别慢？

慢的核心是没启用缓存，或缓存没命中。Composer 默认每次从零下载全部包，而 GitHub Actions 的默认 cache 机制对 vendor/ 目录支持弱——它更适合缓存 Composer 自身的 global cache（即 ~/.composer/cache），而不是整个 vendor/。

• 优先缓存 Composer 的 HTTP 缓存目录：~/.composer/cache，key 基于 composer.lock hash，恢复快且稳定
• 避免直接缓存 vendor/：它体积大、易受权限/OS 差异影响，且 GitHub cache 有 10GB 限制，容易爆
• 加 -n（非交互）和 --quiet 减少日志 IO，尤其在高并发 runner 上能省几百毫秒

PHP 版本不匹配导致 composer install 失败怎么办？

错误信息像 Your requirements could not be resolved to an installable set of packages.，但实际是 Composer 检测到当前 PHP 版本低于 composer.json 里 config.platform.php 或 require.php 声明的最低版本。

• 先用 php -v 确认 runner 实际 PHP 版本（GitHub Actions 的 setup-php action 可能没生效）
• 显式设置平台版本：在 composer install 命令前加 COMPOSER_PLATFORM_CHECK=0（绕过检查），或更稳妥地，在 composer.json 的 config 下设 "platform": {"php": "8.2"}
• 不要依赖 setup-php 的 auto-install —— 显式指定版本，例如 php-version: '8.2'，并勾选 extensions（如 mbstring, xml），缺一个扩展就可能让某个包安装失败

有些问题表面是 Composer 报错，实际是 PHP 扩展缺失、lock 文件未提交、甚至 .gitignore 里误删了 composer.lock —— CI 不会提醒你“你忘了 commit lock”，它只会安静地装错版本。