换镜像源更管用是因为国内80%中断源于直连packagist.org时dns解析卡顿、tls握手失败或中间设备断连，阿里云/腾讯云镜像已绕过这三重网络阻塞；而重试参数仅在“能连上”前提下生效，若根本连不上则无效。
为什么换镜像源比调重试参数更管用
国内用户遇到的“安装中断”，80% 不是网速慢，而是直连 packagist.org 或 GitHub API 时卡在 DNS 解析、TLS 握手失败、中间设备主动切断长连接。阿里云、腾讯云镜像站已针对性解决这三重瓶颈，CDN 覆盖广、响应稳定。
关键点在于：镜像不是“加速下载”，而是绕过根本性网络阻塞。所有重试参数（如 process-timeout、http.timeout）都建立在“能连上”的前提下——如果连不上，调再久也没用。
-
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/是唯一有效起点，缺一不可：必须带-g、键名必须是repo.packagist（不是repos.packagist）、composer是 type 值（不是可选注释）、URL 必须以https://开头且末尾带/ - 配置后必须执行
composer clear-cache，否则缓存里仍存着旧源的元数据，Composer 会继续尝试从packagist.org拉取校验信息 - 验证是否真生效：运行
composer require monolog/monolog -vvv 2>&1 | grep "GET\|Downloading"，输出 URL 中必须含mirrors.aliyun.com，而非packagist.org
中断后该不该删 vendor 目录
不能一概而论。先看 vendor/composer/installed.json 是否存在且结构完整——如果存在，说明部分包已成功写入，直接重跑 composer install 就会跳过已安装项，只补剩余依赖。
但以下情况必须清理：
-
Failed to extract vendor/package-name: unable to open archive：ZIP 文件损坏，通常由镜像返回不完整响应或缓存复用坏包导致 -
Invalid argument supplied for foreach()：大概率是installed.json被截断，文件不完整 -
The zip extension and unzip command are both missing：这不是扩展没开，而是上一步 ZIP 损坏，导致后续解压失败
此时执行顺序必须是：rm -rf vendor → composer clear-cache → composer install --prefer-dist --no-plugins（跳过脚本和插件，降低失败面）。
项目级配置 vs 全局配置，哪个更可靠
全局配置（composer config -g）看似省事，但极易被覆盖：只要项目根目录 composer.json 里定义了 "repositories" 字段（哪怕只有 {"packagist.org": false}），全局镜像就完全失效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
团队协作或 CI/CD 场景下，推荐项目级配置：
- 进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 它会自动在
composer.json顶层添加"repositories"对象，key 固定为"packagist"，不会覆盖已有私有源 - 若项目已有
"repositories"数组，别手动编辑，改用命令追加，避免误删私有仓库配置
CI 脚本中还可配合环境变量：COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install，干净可控。
镜像配置生效但还是卡在 Resolving dependencies
这和镜像无关。镜像只加速下载阶段，不解决依赖解析慢的问题。
常见原因：
-
"php": "^7.4 || ^8.0"这类宽泛版本约束，会让 Composer 尝试大量组合 - 大量未锁定的 dev 分支依赖，如
"monolog/monolog": "dev-main" -
require-dev里塞了太多工具包，增加解析复杂度
临时诊断：运行 composer update --dry-run -vvv，观察日志里 Resolving dependencies 阶段耗时。若超过 30 秒，基本可以确定是本地 composer.json 写法或 PHP 环境问题，不是网络或镜像的事。
真正容易被忽略的是：换镜像后不执行 clear-cache，或者项目级 repositories 配置覆盖了全局设置——这两点导致“看起来配好了，其实没走镜像”，是最常发生的静默失效。
