composer下载卡顿主因是镜像源配置错误：必须严格执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，缺一不可——键名repo.packagist（非repos）、type值composer、url以/结尾，否则静默回退官方源。
Composer下载卡在Downloading...，不是网络差，是没配对镜像源——90% 的“慢”问题靠一条命令就能解决，但写错三个地方就会静默失效。
composer config -g repo.packagist 命令必须写对这三点
这条命令看似简单，但漏掉任意一个细节都会导致 Composer 无声无息地 fallback 回 packagist.org，你完全感知不到它没生效：
-
repo.packagist不能写成repos.packagist（多一个s就彻底失效） - 必须显式传入
composer作为 type 参数：正确是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，错的是漏掉中间那个composer - URL 必须以
/结尾：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（缺斜杠会导致部分 Composer 2.2+ 版本请求packages.json时 404）
全局配置在宝塔/CI 中经常不生效
你在终端里执行了 composer config -g，但宝塔「一键部署」或 Jenkins 脚本里依然慢——因为它们不是用你的用户身份运行的：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer config -g写的是当前用户的配置文件，Linux/macOS 在~/.composer/config.json，Windows 在C:\Users\用户名\AppData\Roaming\Composer\config.json - 宝塔默认用
www用户执行 PHP 命令，Jenkins 用jenkins用户，systemd 服务可能用root或其他专用用户 - 验证方式：在宝塔终端或 CI 脚本开头加
whoami && composer config -g repo.packagist，看输出是不是你预期的 URL - 稳妥做法：给对应用户单独配，例如
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
项目级配置别直接覆盖 repositories
进项目目录后执行 composer config repo.packagist composer ...（不加 -g），它会全量替换 composer.json 里的 repositories 字段——如果你原本有私有 Git 包源，就全丢了：
- 如果
composer.json原来是"repositories": {}，命令会转成标准对象并插入packagist条目 - 如果原来是
"repositories": []（数组），命令会追加新项，不破坏已有源 - 更安全的做法是手动编辑：
"repositories": { "packagist": { "type": "composer", "url": "https://mirrors.aliyun.com/composer/" } }，并确保根节点有"packagist.org": false - 改完后建议跑一次
composer update --lock，让composer.lock记录新源地址
换源后仍卡在 Resolving dependencies？和镜像无关
镜像只加速下载环节；如果 composer update 卡在 Resolving dependencies 几十秒以上，说明问题出在本地约束上：
- 检查
composer.json是否写了过于宽泛的版本约束，比如"monolog/monolog": "*"或"php": "^7.4 || ^8.0" - 确认
config.platform.php和实际 PHP 版本一致，否则求解器要反复尝试兼容版本 - 禁用
xdebug（它会让依赖解析变慢数倍），运行前加php -d zend_extension= -d xdebug.mode=off composer update - 清理缓存：
composer clear-cache，再试composer update --lock（轻量更新，不重算全部依赖）
最容易被忽略的点：镜像同步有延迟（阿里云约 15 分钟），刚发布的包可能还没同步到镜像站。别急着关回退机制，先去镜像站首页查「最后更新时间」，再确认是否真缺失。
