镜像配置错误会导致composer静默回退至packagist.org：必须严格满足三要素——键名repo.packagist（单数）、type值为composer、url以https://开头且结尾带/；任一不符则配置无效，验证需执行composer config -g repo.packagist并确认输出为完整json或含镜像域名的url。
镜像源配置写错一个字符就静默回退到 packagist.org，根本不会报错，但所有包都还在境外下载——这不是网速问题，是配置没生效。
确认 repo.packagist 配置是否真正写入
执行 composer config -g repo.packagist 后，输出必须是完整 URL 字符串（如 https://mirrors.aliyun.com/composer/）或标准 JSON 对象（含 "type": "composer"）。如果输出 null、空行、或仍是 https://packagist.org，说明配置失败。常见原因包括：
-
repo.packagist写成repos.packagist（多一个s就彻底失效） - 命令漏掉中间的
composer类型参数：composer config -g repo.packagist https://...❌，正确是composer config -g repo.packagist composer https://...✅ - URL 末尾没加
/：例如https://mirrors.aliyun.com/composer会拼成/composerpackages.json导致 404 - Windows 下权限不足时提示 “Could not write to …”，可加
--no-plugins重试
验证请求是否真发到了镜像域名
光看配置输出没用，得在日志里亲眼看到请求地址。运行：
composer show laravel/framework -vvv 2>&1 | grep "Downloading"
日志中必须出现 mirrors.aliyun.com、mirrors.tuna.tsinghua.edu.cn 等镜像域名。如果还看到 packagist.org 或 github.com，说明：
- 项目级
composer.json中存在"repositories"字段（哪怕只是{}），它会直接覆盖全局配置 -
composer.lock里记录的是旧源的dist.url，install会先尝试这个地址，超时才 fallback - 本地缓存仍存着官方源的元数据，Composer 优先读缓存，根本不会发新请求
调高并发下载数并清理干扰项
Composer 2.2+ 默认仅开 3 个并发线程，远未利用带宽。必须手动设为 8–10：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer config -g http-max-concurrent-downloads 10
注意：parallel-downloads 已废弃，设了也不生效。同时需排除以下本地干扰：
- 启用
xdebug会让依赖解析慢 5–10 倍：临时禁用php -d xdebug.mode=off $(which composer) install - 默认内存限制
128M不够：加COMPOSER_MEMORY_LIMIT=-1再试 -
platform配置与实际 PHP 版本不匹配（如"php": "7.4"却在 PHP 8.2 上运行），会触发降级查找逻辑 - 删掉
vendor/和composer.lock，再跑composer install --no-cache
CI/CD 或多环境场景下避免镜像漂移
CI 环境每次构建都是干净环境，不能依赖本地全局配置。最可靠方式是用环境变量指定源：
COMPOSER_REPO_PACKAGIST=https://mirrors.tencent.com/composer/ composer install
GitHub Actions 示例中，应在 run 前加 env: 块；Docker 构建时也建议用 ENV COMPOSER_REPO_PACKAGIST=...。切忌在 composer.json 里硬编码 repositories，否则开发/测试/生产环境策略无法隔离。
最易被忽略的是：镜像只加速元数据和 ZIP 包下载，不解决 Resolving dependencies 阶段的卡顿——这个阶段完全不走网络，纯靠本地 CPU 暴力求解，出问题要查内存、xdebug、platform 和 lock 文件残留。
