Composer拉取特定分支的代码慢？优化Git流与镜像配置【技巧】-composer-PHP中文网

composer拉取dev-*分支慢的根本原因是强制git克隆绕过镜像加速，因镜像仅缓存zip包而不托管git仓库，必须直连原始仓库完整克隆、检出分支并初始化子模块，无法利用--prefer-dist、缓存或并发下载；强制走zip需包含dist声明、手动配置repositories为package类型或依赖带tag的@dev版本。

composer拉取特定分支的代码慢？优化git流与镜像配置【技巧】

Composer拉取特定分支（比如dev-master或dev-feature/x）慢，根本原因不是“分支本身慢”，而是 Composer 强制走 Git 克隆流程，绕过了镜像加速，且默认不复用已有仓库、不设深度、不跳过检出——这些行为在 CI 或多分支开发中会指数级放大耗时。

为什么`dev-*`分支拉取不走镜像？

镜像源（如阿里云、清华）只缓存 .zip 发布包（dist），不托管 Git 仓库。当你声明依赖为"monolog/monolog": "dev-main"，Composer 就必须：

发起 Git clone 请求到原始仓库（如 https://github.com/Seldaek/monolog.git），完全绕过 repo.packagist 配置
执行完整克隆（含全部历史）、checkout 到目标分支、submodule 初始化等操作
无法利用 --prefer-dist、cache-files-dir 或并发下载优化

怎么强制让分支也走 ZIP 包？

只有满足以下任一条件，Composer 才可能 fallback 到 dist：

包作者在 composer.json 中显式声明了 "dist": { "url": "...", "type": "zip" }（极少见）
你手动在项目 composer.json 的 repositories 中添加一个 type=package 的条目，指向预构建的 ZIP 地址（需自行维护）
使用 composer require vendor/package:dev-main --prefer-dist，但前提是该分支有对应 tag 或 GitHub Release（否则仍 fallback 到 git clone）

更现实的做法是：避免直接依赖 dev-* 分支。改用 ^x.y.z@dev（如 "monolog/monolog": "^2.10.0@dev"），它会优先匹配最近的稳定 tag，并启用 dist 下载。

Github Actions Linter

对 GitHub Actions 工作流 YAML 文件进行 lint 与验证，检查常见错误、安全隐患、已废弃的操作以及最佳实践。适用于要求进行代码检查、验证等场景。

下载

Git 克隆阶段还能怎么提速？

若必须走 Git（如内部私有库、未打 tag 的功能分支），可通过环境变量和配置压减开销：

设 COMPOSER_DISABLE_FS_CHECKS=1：跳过 Git 工作区完整性校验（CI 中安全）
加 --no-interaction + --quiet：减少终端 I/O 和 prompt 等待
用 git config --global core.sparseCheckout true 配合 .git/info/sparse-checkout（需自定义脚本注入）来跳过无关目录
禁止 submodule：COMPOSER_NO_INTERACTION=1 git clone --depth=1 --no-single-branch --recursive=false ...（Composer 不直接支持，需 patch 或 wrapper 脚本）

注意：--depth=1 在 Composer 内部不可控，它始终用 git clone 而非 git archive，所以浅克隆需靠 Git 全局配置或提前 cache。

CI 中拉取 dev 分支卡住？先查这三件事

CI 日志里出现 Cloning into '...'... 卡住超过 60 秒，大概率不是网络问题：

ssh-agent 未启动或 key 未加载 —— 改用 HTTPS URL（https://git.example.com/repo.git），并配 COMPOSER_AUTH JSON
Docker 容器内 DNS 缓存失效 —— 在 before_script 加 nslookup github.com 和 getent hosts github.com 验证解析
Git 仓库启用了 large file storage（LFS）但 CI runner 没装 git-lfs —— 直接报错或静默卡死

真正难排查的是：某些私有 Git 服务（如 Gitea、GitLab CE）对未认证的 git ls-remote 请求响应极慢，Composer 在确定分支 commit hash 前会先发这个请求 —— 此时加 COMPOSER_VERBOSE=1 可看到卡在哪一步。