Composer换源失败主因有三：键名必须为repo.packagist（单数）、type值“composer”不可省略、URL须HTTPS且结尾带/；验证需输出完整JSON；全局配置(-g)仅限本用户，生产环境应优先用项目级配置或--repository临时指定。
composer config -g repo.packagist 命令总没反应？检查这三处硬伤
命令跑完没报错、composer install还是卡在 Loading composer repositories，大概率是配置根本没写进去——Composer 2.2+ 会静默 fallback 到官方源，不提示任何错误。
-
repo.packagist键名必须是单数，写成repos.packagist或packagist.org就无效 - 中间的
composer是 type 值，不是可选参数，漏掉就直接退回到https://packagist.org - URL 必须是 HTTPS 且末尾带
/：比如https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/composerpackages.json导致 404
验证是否生效，只看这一行：composer config -g repo.packagist。输出必须是完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、纯 URL 字符串，都说明失败。
全局配置 vs 项目级配置：什么时候该用哪一种
全局配置（加 -g）只影响你当前终端用户，CI/CD、宝塔后台、Docker 容器里基本不认它；项目级配置写进 composer.json，Git 可追踪、协作可复现，才是生产环境首选。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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/ - 团队项目或 CI 环境：进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g），它会安全合并到composer.json的repositories字段，不破坏已有私有源 - 宝塔面板常见问题：Web 服务以
www用户运行，需先切换用户再配：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
换源后 still loading？清缓存和旧文件才是关键
镜像只加速下载，不加速元数据解析。Composer 会优先读本地缓存和 composer.lock 中记录的旧地址，哪怕你刚配好新源，它仍可能反复请求 packagist.org。
- 先执行
composer clear-cache - 删掉项目下的
vendor/和composer.lock - 再运行
composer install -vvv，观察日志里是否出现mirrors.aliyun.com或对应镜像域名 - 如果还卡在 “resolving dependencies”，不是镜像问题，而是版本约束太宽（如
"^2.0"）导致回溯过深，此时应优先用composer install恢复已有锁文件
临时切镜像：单次命令有效，适合调试和 CI
不想动全局或项目配置？用 --repository 参数最干净，本次命令结束后自动失效，适合验证包是否存在、绕过代理、或在 GitHub Actions 中快速对比不同镜像稳定性。
- 临时走阿里云：
composer create-project laravel/laravel demo --repository=https://mirrors.aliyun.com/composer/ - 临时走腾讯云：
composer install --repository=https://mirrors.cloud.tencent.com/composer/ - 注意：
--repository会完全忽略全局和项目级配置，但若镜像中尚未同步新包（尤其刚发布的dev-main），仍会报Could not find package xxx
镜像同步有 5–30 分钟延迟，别在发版后立刻查新包——先去镜像站网页搜，再决定要不要等或换源。
