如何在GitHub Actions中缓存Composer依赖以加快构建速度？

推荐缓存Composer全局缓存目录~/.composer/cache，以hashFiles('**/composer.lock')为键确保依赖变更自动失效；可选叠加缓存vendor/但需包含PHP版本以避免兼容问题。

在GitHub Actions中缓存Composer依赖，核心是用actions/cache动作保存vendor/目录或Composer的全局缓存路径（~/.composer/cache），并基于composer.lock文件内容生成缓存键，确保依赖变更时自动失效。

推荐方式：缓存 Composer 全局缓存目录

这是最稳定、兼容性最好的做法。Composer自身会把下载的包、已编译的autoload文件等存入~/.composer/cache，缓存该路径能复用下载和解压过程，大幅减少网络和IO开销。

示例工作流片段：

- name: Cache Composer cache
  uses: actions/cache@v4
  with:
    path: ~/.composer/cache
    key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}

登录后复制

说明：

• path 必须写成~/.composer/cache（不是vendor/），避免权限或路径解析问题；
• key 使用hashFiles('**/composer.lock')可精确响应依赖变更；若项目有多个composer.lock（如子模块），需调整glob模式；
• 建议在composer install前执行此步骤，且无需额外配置COMPOSER_CACHE_DIR，GitHub Actions默认环境已支持。

补充策略：同时缓存 vendor 目录（可选）

对某些纯PHP项目或CI时间特别敏感的场景，可叠加缓存vendor/目录，但需注意风险：

标签： php git composer github 解压