composer国内安装必须配镜像，否则大概率卡死或403；全局配置composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/需严格满足三要素：键名repo.packagist（非repos）、中间composer为必填type值、url末尾带斜杠，缺一即静默回退官方源。
不配中文镜像，Composer 在国内基本装不完——不是慢，是大概率卡在 Downloading、报 403 或直接超时。镜像不是“可选优化”，而是能跑起来的硬性前提。
composer config -g repo.packagist 命令总不生效？检查这三处
90% 的“配了没用”问题，都卡在这三个细节上，且 Composer 2.x 会静默回退到官方源，不报错也不提示：
-
repo.packagist键名不能写成repos.packagist（多一个s就完全失效） - 中间那个
composer是type参数，必须显式写出：正确是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，漏掉就白配 - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致请求变成/composerpackages.json，直接 404）
全局配置 vs 项目级配置：什么时候该用哪个
全局配置省事，但有隐藏优先级陷阱；项目级更可控，尤其在协作或 CI 场景下：
- 全局配置（
composer config -g）写入~/.config/composer/config.json，所有项目共享。适合个人开发，或团队初始化脚本固化 - 项目级配置（去掉
-g，在项目根目录运行）会往composer.json的repositories字段追加，只影响当前项目。如果已有repositories，命令会自动合并，不会覆盖私有源 - 注意优先级：项目级 > 全局 > 默认源。只要
composer.json里有"repositories": {}（哪怕空对象），全局配置就完全失效
验证镜像是否真在用，别只看命令返回
执行 composer config -g repo.packagist 输出为空、null、或仍是 https://packagist.org，说明根本没写进去。更可靠的验证方式是：
- 运行
composer diagnose，盯紧输出中Repo packagist.org:后面的域名是不是你设的镜像地址 - 加
-vvv跑一次安装：composer install -vvv 2>&1 | grep -i "mirrors\|packagist"，确认实际发起请求的 host 是镜像站（如mirrors.aliyun.com） - 日志里出现大量
GET https://mirrors.aliyun.com/composer/或Downloading xxx.zip→ 镜像已生效；若长时间停在Resolving dependencies，和镜像无关，得查 PHP 内存、xdebug、或composer.json版本约束太宽
宝塔、Docker、CI 环境里容易被忽略的用户权限问题
这些环境默认不以 root 运行 Composer，全局配置写错位置等于白配：
- 宝塔面板中，PHP 管理器、计划任务、一键部署通常以
www用户运行，而sudo composer config -g写的是 root 的配置。正确做法是：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - Docker 构建时，
RUN composer config -g写入的配置不会持久化到镜像层，必须在RUN指令中显式执行，或直接写进composer.json的repositories - CI 流水线（如 GitHub Actions）中，避免用
sudo composer config -g，否则配置写进 runner 的 root 用户目录，而构建步骤可能以普通用户运行
镜像只解决元数据拉取和 ZIP 下载环节，但 Resolving dependencies 卡住、GithubRateLimitException、或 Signature mismatch 这类错误，和镜像无关，得单独排查依赖解析逻辑、GitHub Token、或包签名校验配置。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
