composer装依赖卡在downloading或loading repositories，90%因未正确切换国内镜像源：命令写错（如repos.packagist多s）、缓存未清、url缺末尾/导致404；须用composer config -g repo.packagist和composer install -vvv双验证实际请求地址是否为镜像域名。
composer 装依赖卡在 Downloading... 或 Loading composer repositories，90% 不是网络差，而是没切对国内镜像源——命令写错、缓存没清、URL 少斜杠，三者任一出问题都会静默失效。
确认当前镜像是否真生效
别只看命令有没有执行，要看 Composer 实际连的是哪个地址：
- 运行
composer config -g repo.packagist，输出必须是完整 URL 字符串（如https://mirrors.aliyun.com/composer/）或标准 JSON 对象（含"type": "composer"和该 URL）；返回null、空值、https://packagist.org或报错，说明配置失败 - 再跑一次
composer install -vvv，最后几行必须出现类似Reading packages.json from cache at .../https---mirrors-aliyun-com-composer/才算真正走镜像；如果还看到packagist.org/packages.json，就是 fallback 了 - 常见静默失败原因：
repo.packagist写成repos.packagist（多一个 s）、漏掉composer类型参数、URL 末尾缺/（变成.../composerpackages.json导致 404）
全局换源：一条命令 + 必清缓存
推荐阿里云镜像（同步快、CDN 稳），但必须严格按格式执行：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 执行命令：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意：带-g、repo.packagist、composer类型、HTTPS、末尾/） - 立刻清缓存：
composer clear-cache（这步跳过，90% 的“换源无效”就出在这里） - 验证：再跑
composer config -g repo.packagist和composer install -vvv，双确认 - 不建议用已停更的旧地址，如
https://packagist.laravel-china.org（2025 年底下线）、https://packagist.phpcomposer.com（返回 404）
项目级配置：适合团队协作和 CI 场景
全局配置在宝塔、Docker 或 CI 流水线中容易因用户权限失效（比如 www 用户读不到 root 的 ~/.composer/config.json），这时项目级更可靠：
- 进项目根目录，执行：
composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/（去掉-g） - 它会自动在
composer.json的repositories字段里加一条"packagist"，不会覆盖已有私有源（前提是repositories是对象，不是数组） - 若
composer.json已有"repositories": []数组结构，别手动覆盖，改用命令追加，否则可能删掉私有包源 - 该配置可提交 Git，队友拉代码后自动生效，
composer.lock哈希也一致
卡住 ≠ 镜像问题：区分下载慢和解析慢
镜像只加速元数据拉取和 ZIP 包下载，不解决依赖求解卡顿。用 -vvv 日志定位真实瓶颈：
- 卡在
Downloading、Fetching dist、大量GET .../dist/xxx.zip—— 换镜像 +clear-cache+parallel-downloads 10能立竿见影 - 卡在
Resolving dependencies through SAT超过 10 秒 —— 和镜像无关，是composer.json版本约束太宽（如"php": ">=7.4"）、含太多dev-main、或开了classmap-authoritative导致重扫 vendor - 此时应：
composer install（有 lock 就别用 update）、收紧 PHP 版本（如"php": "^8.1"）、关掉classmap-authoritative（composer config authorative false）
repo.packagist 错打成 repos.packagist——这三个点都不报错，但全白配。
