根本原因不是镜像被屏蔽，而是配置写错导致静默失效：必须严格满足三要素——键名repo.packagist（单数小写）、中间composer为type值（不可省略）、URL以/结尾且为HTTPS；任一错误均不报错但实际无效。
composer config -g repo.packagist 命令为什么总不生效
根本原因不是镜像被屏蔽，而是配置写错了却静默失败——命令跑完没报错，但 composer install 依然连 packagist.org。关键就三点：repo.packagist（不能多写一个 s）、中间的 composer（这是 type 值，不是可选参数）、URL 必须以 / 结尾且用 https://。
常见错误示例：
-
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/→ 多了个s，完全无效 -
composer config -g repo.packagist https://mirrors.aliyun.com/composer/→ 少了composer类型声明，Composer 2.x 会 fallback 到默认源 -
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer→ 缺末尾斜杠，请求路径变成/composerpackages.json，返回 404
验证是否真写入成功：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或报错，说明没生效。
项目级配置覆盖全局设置怎么办
只要项目根目录的 composer.json 里有 repositories 字段，全局镜像就自动失效——这不是 bug，是 Composer 的设计行为。优先级顺序固定为：项目级 > 全局 > 默认源。
排查步骤：
- 运行
composer config repo.packagist（无-g），看是否有输出；有输出说明项目级已覆盖 - 检查
composer.json是否含"repositories": [...]，哪怕只有一行{"packagist.org": false}也会压掉全局配置 - 运行
composer diagnose，看Repo packagist.org:后面是不是你设的镜像地址；如果不是，基本就是被项目级覆盖了
修复建议：如果想保留项目级控制，直接在项目根目录执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g），它会安全合并进 repositories，不会清空已有私有源。
CI/CD 或宝塔环境里镜像不生效
这类环境常因用户权限错位导致镜像配置“写了等于没写”。比如在宝塔面板中，PHP 管理器或计划任务是以 www 用户身份运行命令，但 composer config -g 默认写的是当前登录用户的 ~/.composer/config.json（通常是 root），www 用户根本读不到。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
解决办法：
- 确认实际执行 Composer 的用户（如
www），然后切换到该用户再配：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本中避免用
sudo composer config -g，否则写进root配置，而构建进程用普通用户运行，配置不可见 - 更稳妥的做法是改用项目级配置，把镜像写进
composer.json，这样所有环境行为一致，无需依赖用户级文件
注意：部分 IDE（如 PHPStorm）会缓存 Composer 配置，改完全局设置后需重启 IDE 才能识别。
镜像地址返回 404 或超时，怎么快速验证
别信“命令跑完了”或“下载变快了”，最可靠的方式是看真实 HTTP 请求日志。Composer 的元数据可能走镜像，但 ZIP 包仍从 GitHub 拉（尤其当项目硬写了 dist-url）。
实操验证方法：
- 先清缓存：
composer clear-cache - 执行带详细日志的命令：
composer require monolog/monolog -vvv 2>&1 | grep "GET\|Downloading" - 观察输出里的 URL 域名：必须是
mirrors.aliyun.com这类镜像地址，而不是packagist.org或github.com
临时绕过所有配置验证某个镜像是否可用：composer install --repository-url=https://mirrors.tuna.tsinghua.edu.cn/composer/ -vvv。这个参数会彻底忽略项目和全局配置，强制只连指定地址——适合排查网络连通性问题。
镜像本身不解决 Resolving dependencies 卡顿问题。如果 composer update 卡在这一步，和镜像无关，大概率是 composer.json 里 PHP 版本约束太宽、dev 包未锁定、require-dev 工具链过多导致的。
