应优先缓存Composer全局缓存目录（如~/.composer/cache）而非vendor/，配合--no-scripts --no-autoloader --prefer-dist参数，在GitLab CI用cache关键字、GitHub Actions用actions/cache@v4，以composer.lock哈希为key，可稳定提速50%以上。
在CI/CD中缓存Composer依赖，核心是复用vendor/目录或~/.composer/cache，避免每次构建都重新下载和安装包。关键不是只缓存vendor（因含环境相关文件易出错），而是优先缓存Composer全局缓存目录，并配合--no-scripts --no-autoloader等安全参数。
GitLab CI：用cache关键字缓存Composer全局缓存
GitLab支持基于路径的路径级缓存，适合缓存~/.composer/cache（Composer默认缓存位置）：
- 在
.gitlab-ci.yml中为PHP作业启用cache，指定key: $CI_JOB_NAME或更稳定的composer.lock哈希值 - 使用
before_script确保COMPOSER_CACHE_DIR指向缓存路径（如$CI_PROJECT_DIR/.composer-cache），并设COMPOSER_NO_INTERACTION=1 - 运行
composer install --no-scripts --no-autoloader --prefer-dist，跳过可能失败的脚本和autoload生成（留到部署阶段）
示例片段：
php-test:
image: php:8.2
before_script:
- export COMPOSER_CACHE_DIR="$CI_PROJECT_DIR/.composer-cache"
- mkdir -p "$COMPOSER_CACHE_DIR"
cache:
key: "$CI_JOB_NAME-composer-cache"
paths:
- "$CI_PROJECT_DIR/.composer-cache"
script:
- composer install --no-scripts --no-autoloader --prefer-distGitHub Actions：用actions/cache复用Composer缓存
GitHub官方推荐用actions/cache@v4缓存~/.composer/cache，并用composer install的lock文件哈希作为缓存key：
- 用
hashFiles('composer.lock')生成唯一key，确保依赖变更时自动失效缓存 - 设置
path: ~/.composer/cache，并提前用composer config --global cache-dir ~/.composer/cache固定路径 - 建议加上
--ignore-platform-reqs（若CI PHP版本与本地不一致），但生产构建应尽量保持环境一致
示例步骤：
Find JSON Path Online
下载
Easily find JSON paths within JSON objects using our intuitive Json Path Finder
- name: Cache Composer dependencies
uses: actions/cache@v4
with:
path: ~/.composer/cache
key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
restore-keys: |
${{ runner.os }}-composer-
- name: Install dependencies run: composer install --no-scripts --no-autoloader --prefer-dist env: COMPOSER_NO_INTERACTION: 1
进阶技巧：跳过autoload优化冷启动
首次缓存未命中时，composer install仍需解压+安装，可进一步提速：
- 加
--classmap-authoritative（发布环境适用），减少运行时类查找开销 - CI中不生成autoload（用
--no-autoloader），改用composer dump-autoload --classmap-authoritative单独执行（更可控） - 若项目含大量私有包，确认
auth.json已安全注入（GitLab用variables，GH Actions用secrets），避免认证失败中断缓存
避坑提醒：哪些不该缓存？
以下内容**不要**纳入CI缓存，否则易引发隐性错误：
-
vendor/目录本身（含bin/软链接、扩展编译产物，跨环境不兼容） -
composer.lock（它是输入，不是缓存产出；应由开发提交，CI只读取） -
autoload_classmap.php等生成文件（应在构建末尾统一生成，而非复用旧缓存）
基本上就这些。缓存Composer全局目录 + lock哈希key + 安全安装参数，三者配合就能稳定提速50%以上，且不增加维护负担。
