必须在builder阶段执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，带type值和末尾斜杠，清缓存并避免项目级repositories覆盖，否则无效。
在 Alpine Linux 微型镜像中配 Composer 中文镜像，不是加一行 config 就完事——必须在 builder 阶段执行、带完整 URL 末尾斜杠、清缓存、且不能被项目级 repositories 覆盖，否则根本不起作用。
composer config -g repo.packagist 命令必须带完整参数和末尾 /
全局换源唯一有效命令是：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。漏掉 composer（type 值）或末尾 /，配置就写成空对象或无效 URL，composer install -vvv 日志里依然出现 packagist.org。
-
repo.packagist不能写成repos.packagist或repositories -
composer是 type 字段值，不可省略；阿里云地址必须以/结尾，否则解析失败 - 执行后立刻验证：
composer config -g repo.packagist输出应为完整 JSON：{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}
Docker 构建中必须清缓存且避免 COMPOSER_HOME 冲突
CI/CD 或多阶段构建里，~/.composer 默认路径会被并发 job 污染，导致镜像内换源失效。不能依赖宿主机配置，也不能让多个 RUN 共享同一 COMPOSER_HOME。
PyCharm 2026.2.0.1 Linux版提供 JetBrains 官方 2026.2.0.1 版本安装包，适合需要指定 PyCharm 版本进行 Python 项目开发、运行和调试的用户。
- builder 阶段统一用临时路径：
RUN COMPOSER_HOME=/tmp/composer-home-$$ composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 紧接着运行：
RUN COMPOSER_HOME=/tmp/composer-home-$$ composer clear-cache，否则旧元数据仍生效 - 所有后续
composer install命令都需带上相同COMPOSER_HOME环境变量
项目级 repositories 会完全屏蔽全局镜像配置
只要 composer.json 里有 "repositories" 字段，全局配置就彻底失效——这是 Composer 的设计逻辑，不是 bug。
- 若项目必须自定义源（如私有包），需显式禁用默认源：
"packagist.org": false - 国内镜像必须放在
"repositories"数组第一位，否则第一个源超时卡满 30 秒才试下一个 - 正确写法示例：
{"repositories": [{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}], "packagist.org": false}
Alpine 中 HTTPS 握手失败常被误判为“换源没用”
日志卡在 Loading composer repositories，未必是镜像地址错，更可能是 PHP 读不到 CA 证书，导致连 mirrors.aliyun.com 都无法 TLS 握手。
- 先确认 OpenSSL 扩展启用：
php -m | grep openssl - 再检查证书路径：
php -r "print_r(openssl_get_cert_locations());"，看default_cert_file是否存在且可读 - Alpine 下常见修复：
RUN apk update && apk add ca-certificates && update-ca-certificates
最容易被忽略的是：换源只解决下载慢，不解决扩展缺失或权限问题。哪怕镜像地址全对，ext-zip not available 或 Do not run as root 仍会让 composer install 直接退出——这些得在换源前就搞定。
