Composer换源需满足三个硬性条件：repo.packagist必须为单数、type值显式写为composer、URL末尾带/；Git Bash下需改%APPDATA%\Composer\config.json；dist包走镜像需清除缓存且项目无硬编码dist字段。
直接换阿里云镜像源就能解决 90% 的 Connection timed out 和卡在 Downloading 的问题，但命令写错、缓存没清、项目配置覆盖，都会让换源“看似成功实则无效”。
composer config -g repo.packagist 命令为什么总不生效
不是网络问题，是三个硬性条件漏掉任意一个就静默失败：
-
repo.packagist必须是单数repo，写成repos.packagist或repositories.packagist.org都会写进错误字段，composer config -g repo.packagist查出来是空或null - 必须显式写出
composer这个 type 值：完整命令是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，漏掉中间的composer，新版 Composer 会 fallback 到官方源 - URL 末尾必须带
/：写成https://mirrors.aliyun.com/composer会导致请求拼成https://mirrors.aliyun.com/composerpackages.json，直接 404
Windows + Git Bash 下换源后还是走 packagist.org
Git Bash 默认不读 ~/.composer/config.json，而是读 Windows 路径下的 %APPDATA%\Composer\config.json，所以你改了 Linux 风格路径，实际根本没生效。
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，输出为空？说明没写对位置 - 正确做法：手动打开
%APPDATA%\Composer\config.json，确认里面repo.packagist字段已存在且格式正确 - 或者改用管理员权限打开 Git Bash，再执行命令；部分环境还需重启终端才能刷新
COMPOSER_HOME缓存
换源后 update 还是从 github.com 下 zip 包
镜像源只管元数据（packages.json），dist 包（zip/tar）默认仍走原始地址。阿里云镜像虽自动映射 dist，但前提是项目里没硬编码 "dist-url" 或 "dist" 字段。
- 检查项目
composer.json，删掉任何含dist的字段，尤其是"dist": { "url": "..." }这类手动配置 - 运行
composer update -vvv，观察日志里Downloading的 URL：要是出现github.com或packagist.org，说明 dist 没走镜像 - 不用额外配 dist 映射——阿里云已自动处理，只要元数据源对了，dist 请求就会被重定向到
mirrors.aliyun.com
CI/CD 或宝塔面板里换源失败的典型原因
权限和环境隔离比本地更严格，常见坑点集中在三处：
- CI 流水线用
sudo composer config -g，结果写进了root用户的~/.composer/config.json，但构建进程以普通用户运行，完全读不到 - 宝塔面板中 PHP CLI 函数被禁用（
proc_open、putenv），Composer 启动失败，根本走不到换源那步；得先去「PHP 管理 → 禁用函数」里删掉这三项 - 宝塔终端未将 PHP 加入 PATH，
php -v报错，导致composer命令本身都执行不了；需手动建软链接：ln -sf /www/server/php/80/bin/php /usr/local/bin/php
最易被忽略的是：换源命令执行完，必须立刻 composer clear-cache。否则旧的 packages.json 元数据还躺在本地，install 时照样连错地址，连 diagnose 都看不出问题。
