推荐缓存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/目录，但需注意风险：
- 必须保证缓存键包含
composer.lock哈希 + PHP版本（如${{ matrix.php-version }}），否则不同PHP版本间混用会导致运行时错误； - 需在
composer install后显式保存，且清除旧vendor/再还原，避免残留文件干扰； - 不推荐单独使用此方式，因
vendor/体积大、平台相关性强，失效率高。
关键配置细节
确保缓存真正生效，还需注意以下几点：
- 在
composer install命令中添加--no-interaction --prefer-dist --optimize-autoloader，启用高效安装模式； - 避免在
composer install前手动rm -rf vendor，这会破坏缓存逻辑； - 如果使用自定义
COMPOSER_HOME，需同步更新path和key中的路径； - 首次运行或
composer.lock变更时，缓存未命中属正常现象，后续构建才会加速。
验证缓存是否生效
在Actions日志中搜索关键词：
- “Cache hit” 表示成功复用缓存；
- “Cache miss” 表示重建缓存，检查
key是否变化或composer.lock是否被忽略； - 对比两次构建中
composer install耗时，通常可降低50%–80%。
不复杂但容易忽略。
