composer镜像配置失效主因是命令错误：repo.packagist拼写错误、漏掉composer type值、url缺末尾/或未用https；必须执行composer config -g repo.packagist验证输出为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，并手动删除vendor和composer.lock才能生效。
Composer 镜像源配不对，composer install 就永远卡在 Loading composer repositories with package information —— 不是网络差，是配置静默失效，连报错都没有。
为什么 composer config -g repo.packagist 总是不生效
这条命令看似简单，但漏掉任意一个要素，Composer 就会直接忽略它，继续连 packagist.org：
-
repo.packagist不能写成repos.packagist（多一个s就完全无效） - 必须显式写出
composer作为type值，不能省略；省略后 Composer 2.x+ 会 fallback 到默认源 - 镜像 URL 必须以
/结尾，例如https://mirrors.aliyun.com/composer/✅，少斜杠会导致请求路径拼错，返回 404 - 必须用 HTTPS，HTTP 地址在 Composer 2.9+ 中会被拒绝
验证是否写对，只看这一条命令输出：composer config -g repo.packagist。正确结果应为完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；返回空、null 或报错，说明没写对。
项目级配置为什么比全局更可靠
全局配置依赖用户环境（比如宝塔里 www 用户读不到 /root/.composer/config.json），而项目级配置写进 composer.json，Git 可追踪、CI 可复现、新人拉代码即生效，且优先级更高：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须把镜像对象放进
repositories数组的**首位**，不是对象；错误写法："repositories": {"packagist": {...}}（这是对象，Composer 会忽略） - 必须显式禁用官方源：
{"packagist.org": false}是独立项，放在repositories外层根节点，不能塞进某个仓库对象里 - 执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g）会清空整个repositories字段，覆盖你已有的私有源 - 改完后必须手动删掉
vendor/和composer.lock，再跑composer install；update没用，它照着旧 lock 文件里的 dist URL 下载
换源后依然卡在 Resolving dependencies 怎么办
镜像只加速包文件下载（.zip/.tar），不参与依赖解析。如果你发现 composer update 卡在 Resolving dependencies 超过 10 秒，问题和镜像无关：
- 检查
composer.json是否写了过于宽泛的版本约束（如"^1.0 || ^2.0"），导致解析器穷举组合 - 确认 PHP 环境已启用
openssl和zlib扩展：php -m | grep -E 'openssl|zlib' - 某些 CI 环境（如 GitHub Actions）默认缓存
composer.lock，需加步骤清理：rm -rf vendor composer.lock - 依赖解析慢还可能源于本地 DNS 或 hosts 干扰，可临时加
--no-plugins排查插件影响
CI/CD 和团队协作中的配置陷阱
全局配置在自动化流程中不可靠，因为环境干净、无用户态配置。推荐以下做法：
- CI 流水线中统一用环境变量注入：
COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install - 团队项目必须把镜像声明写进
composer.json，并提交 Git；避免成员各自配全局导致install结果不一致 - 宝塔或 Docker 环境中，不要依赖
composer config -g；www用户权限链常断开，应改用项目级或环境变量方式 - 阿里云、腾讯云镜像目前最稳（截至 2026 年 7 月），
packagist.laravel-china.org和packagist.phpcomposer.com已不可靠
真正容易被忽略的是：换源之后，composer.lock 里的 dist URL 仍是旧的，不删它，就永远走不了新镜像——这个动作没有替代方案，必须手动删。
