Composer在Alpine容器报“git not found”是因为默认无Git且依赖触发fallback至git clone；解决需强制--prefer-dist、启用zip/openssl/phar扩展、换源并清缓存，确保全链路走ZIP下载。
为什么 composer install 在 Alpine 容器里报 “git not found”
不是 Composer 本身缺 git，而是 Packagist 上绝大多数包默认以 ZIP 形式分发，但一旦 composer.json 中声明了 "type": "vcs"、引用了私有 Git 仓库、或依赖中某包的 dist URL 缺失/失效，Composer 就会 fallback 到 git clone。Alpine 默认不带 git，此时直接报错：sh: git: not found 或卡在 Cloning into。这不是网络问题，是执行链断在了底层命令缺失。
不装 git 的前提下让 composer install 成功运行
核心思路是：堵住所有可能触发 git 的路径，强制走 ZIP 分发 + 提前校验可用性。需同时满足以下条件：
- 所有依赖必须来自 Packagist 官方源（或镜像），且包元数据中
dist.zip字段完整——这由包作者发布时决定，你无法修改，但可筛选 - 全局配置禁用 VCS 回退：
composer config -g --no-plugins vcs-driver false（Composer 2.5+ 支持） - 安装时加
--prefer-dist（显式优先 ZIP）和--no-interaction（避免交互式提示触发 git） - 确保 PHP 已启用
ext-zip和ext-openssl，否则 ZIP 下载或解压会静默失败
验证是否真走 ZIP：composer install --prefer-dist -v 输出中应出现 Downloading https://.../package-name.zip，而非 Cloning ...。
Alpine 镜像中必须补的最小 PHP 扩展集
缺任何一个，composer install --prefer-dist 都会失败，且错误信息模糊（比如只报 failed to extract）：
批量替换指定目录下所有 Git 仓库的远程地址（remote URL）。 当用户需要将 Git 仓库从一个服务器迁移到另一个服务器时使用。 触发词：git remote 替换、git url 批量修改、git 仓库迁移、更换 git 地址、批量修改 remote url。
-
ext-zip：解压 ZIP 包，不是可选——Alpine 默认禁用，需显式安装：apk add --no-cache php83-zip -
ext-openssl：HTTPS 下载必需，否则连https://mirrors.aliyun.com/composer/都打不开：apk add --no-cache php83-openssl -
ext-phar：运行composer.phar自身所必需：apk add --no-cache php83-phar
验证方式：php -m | grep -E "^(zip|openssl|phar)$" 必须输出三行。别信 php -v 看起来正常——CLI 和 Web SAPI 的扩展加载可能不同。
换源 + 清缓存是绕过 git 依赖的刚性操作
即使你没写任何私有仓库，直连 packagist.org 在国内多数网络下会超时，Composer 会在超时后自动 fallback 到 GitHub/GitLab 的 Git API 获取元数据，从而再次触发 git 调用。所以：
- 必须全局换源：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意末尾/） - 换源后立刻清缓存：
composer clear-cache，否则旧缓存仍可能指向原始域名 - 如果项目已存在
composer.lock，检查它是否含"source": {"type": "git", ...}字段——有就说明之前装过 git 版本，得删掉 lock 文件重生成（仅限开发环境）
最终能跑通的最小 Alpine 构建片段：RUN apk add --no-cache php83-zip php83-openssl php83-phar \u0026\u0026 curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer \u0026\u0026 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ \u0026\u0026 composer clear-cache。之后再 composer install --prefer-dist --no-dev --optimize-autoloader --no-interaction。
