当前仅阿里云和华为云镜像可用，需用正确命令配置全局源、清除缓存与锁文件、检查项目级配置，并验证dns及日志确认生效。
composer install 报 “Could not fetch” 或卡在 Loading composer repositories，基本可以确定是镜像源已失效——不是你网络坏了，而是你配的地址根本连不通。当前（2026年9月）腾讯云、PHPComposer、网易等镜像均已下线，阿里云和华为云是仅有的两个全量同步、HTTPS 可达、无证书错误的可用源。
确认镜像是否真失效：别信“配了就行”
执行 composer config -g repo.packagist 后只看输出：必须是完整 JSON，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。以下情况都说明没生效：
- 输出为空、
null或Key not found - URL 是
https://packagist.org或旧域名（如phpcomposer.com） - 少了末尾斜杠：
https://mirrors.aliyun.com/composer❌（会拼成/composerpackages.json导致 404）
换源必须用对命令和参数
键名、type、URL 格式三者错一个，Composer 就静默 fallback 到官方源，不报错也不提示。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 键名只能是
repo.packagist（单数，不能写成repos.packagist） - 第二个参数必须是
composer（这是 type 值，不是注释） - 推荐命令：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 华为云用户请用：
composer config -g repo.packagist composer https://repo.huaweicloud.com/php/（注意路径是/php/，不是/composer/）
清缓存 + 删锁文件 + 清项目级配置
即使新镜像配对了，旧缓存、旧 composer.lock 和项目级 repositories 字段仍会让请求继续打向失效地址。
- 运行
composer clear-cache；Windows 用户还需手动删%LOCALAPPDATA%\Composer\cache - 删除项目根目录下的
vendor/和composer.lock - 检查
composer.json是否含"repositories"字段：若有，且内容不是{"packagist": false}或指向阿里云/华为云，则删掉整个字段或重写为"repositories": {"packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}}
内网/CI/宝塔环境下特别容易踩坑
全局配置 -g 在宝塔、Docker、GitLab CI 中几乎必然失效，因为它们以 www、runner 等非你当前用户的权限运行 Composer。
- 宝塔用户：用
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 用户（GitHub Actions / GitLab CI）：放弃全局配置，改用项目级命令：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g），它会写入composer.json，可提交 Git，CI 可复现 - 所有环境都要验证：跑一次
composer install -vvv，日志里出现mirrors.aliyun.com或repo.huaweicloud.com才算真正走通
dig mirrors.aliyun.com @8.8.8.8 或切手机热点测试，再折腾配置。否则所有操作都在无效路径上打转。
