镜像配置未生效是因为repo.packagist拼错、url末尾缺/或被项目级repositories覆盖，三者任一即静默回退官方源；验证需通过composer require -vvv日志首行或curl -i测试真实请求地址。
镜像配了却还报 Failed to download 或卡在 retrying，八成不是网络问题，而是配置没真正生效——repo.packagist 拼错、URL 少斜杠、被项目级 repositories 覆盖，三者任一都会让 Composer 安静退回官方源。
为什么 composer config -g repo.packagist 看起来成功了却没用
这条命令本身不报错，但只要满足以下任意一条，就等于白配：
-
repo.packagist写成repos.packagist（多一个s）——Composer 2.0+ 完全忽略，且不提示 - URL 末尾没加
/，比如写成https://mirrors.aliyun.com/composer→ 实际请求变成/packages.json拼接为/composer/packages.json，直接 404 - 项目根目录
composer.json里存在"repositories"字段，它优先级高于全局配置，会彻底屏蔽你刚设的镜像 - 用了
http://开头（如http://mirrors.aliyun.com/composer/）——Composer 强制 HTTPS，触发 301 跳转后，在 Alpine、WAMP 或企业代理下卡死
怎么确认镜像真在走阿里云，而不是“我以为它在用”
别信 composer config -g repo.packagist 的输出，要看实际发出去的请求：
- 运行
composer require monolog/monolog --no-install -vvv，第一行日志必须是Downloading https://mirrors.aliyun.com/composer/ - 如果看到
Downloading https://packagist.org/或Downloading http://，说明配置未生效或被覆盖 - 临时验证：新建空目录，执行
composer init -n && composer require monolog/monolog -vvv，排除项目级干扰 - 更底层验证：
curl -I https://mirrors.aliyun.com/composer/packages.json应返回HTTP/2 200；若 301 或超时，问题在 DNS、代理或本地网络层
换镜像后仍中断下载，必须立刻清理的三项
中断后残留的损坏文件会让后续所有操作循环失败，硬重试毫无意义：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
rm -rf vendor（Linux/macOS）或rmdir /s vendor（Windows）——已解压但不完整的包会污染依赖树 -
composer clear-cache——缓存里可能存着截断的installed.json或校验失败的 ZIP - 删掉项目根目录下的
composer.lock（可选但推荐）——避免锁文件引用旧元数据导致解析错乱
清理完再跑 composer install --prefer-dist --no-plugins -vvv，强制走压缩包、禁用插件、全程跟踪真实 URL。
CI/宝塔/本地环境不一致？镜像配置不会自动继承
你在本地配好的镜像，对 GitHub Actions、GitLab CI 或宝塔面板完全无效：
- GitHub Actions 必须在
.github/workflows/*.yml的steps中显式执行：composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}' - 宝塔面板需确保 PHP CLI 路径正确（如
/www/server/php/81/bin/php），且proc_open、pcntl_signal未被禁用 - Docker 构建中，不能只在宿主机配镜像——要在
Dockerfile的RUN步骤里重复配置，否则构建时仍走默认源
最易被忽略的是同步延迟：阿里云镜像底部标有「最后同步时间」，若超过 2 小时未更新，新发布的包（如刚推的 laravel/pint v1.13.0）在镜像站查不到，不是你配错了，是它还没同步过来。
