Composer全局镜像配置config -g repo.packagist常静默失效，主因是键名必须为单数repo.packagist、第二参数必须显式指定composer类型、URL须以https://开头且末尾带/；任一缺失即回退官方源，且项目级repositories字段会完全覆盖全局配置。
Composer 默认直连 packagist.org，国内访问延迟高、TLS 握手慢、常卡在 Downloading 或报 could not find package ——这不是你网络差，是必须换镜像的信号。
composer config -g repo.packagist 命令为什么总不生效
它不报错，但实际没写进去，最终静默 fallback 回官方源。核心就三点：
-
repo.packagist不能写成repos.packagist（多一个s就彻底忽略） - 第二个参数必须是
composer（这是仓库类型声明，漏掉会走默认源） - URL 必须以
https://开头，且末尾带/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌
验证是否成功：运行 composer config -g repo.packagist，输出应为 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 或至少是完整 URL 字符串。如果为空、null、或仍是 https://packagist.org，说明完全没写进去。
项目级配置会清空你原有的私有源
执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g）时，它不是“追加”，而是全量替换当前项目的 composer.json 中的 repositories 字段。
如果你原本配了 Git 私有包源，比如：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
"repositories": {
"my-private": { "type": "vcs", "url": "https://git.example.com/pkg" }
}
这条命令一跑，整个 repositories 就只剩阿里云镜像，私有源直接消失。
正确做法是手动编辑 composer.json，确保：
-
repositories是数组格式（不是对象），首位为：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 根节点写上
"packagist.org": false（注意：不在repositories内部，而在顶层） - 改完删掉
vendor/和composer.lock，再跑composer install
宝塔、CI、systemd 里镜像还是慢？用户不对
composer config -g 写的是当前用户的配置路径：~/.composer/config.json（Linux/macOS）或 %APPDATA%\Composer\config.json（Windows）。但宝塔后台、Jenkins、systemd 服务往往以 www、jenkins 或其他用户身份运行，根本读不到你 root 或个人用户的配置。
排查和解决方式：
- 在宝塔 PHP 管理器里点「一键部署」前，先用该用户身份执行：
sudo -u www composer config -g repo.packagist，看是否输出预期 JSON - CI 脚本别依赖全局配置，改用临时参数：
composer install -vvv --repository=https://mirrors.aliyun.com/composer/ -
-vvv很关键——它会打印真实请求 URL，一眼就能确认走的是哪个源
最易被忽略的点：镜像只加速元数据拉取和 tarball 下载，不解决 Resolving dependencies 卡顿。如果卡在这里，得收紧 php 版本约束、删掉 "minimum-stability": "dev"、关掉 xdebug，而不是继续折腾镜像。
