全局镜像配置未生效的三大硬性条件：键名必须为 repo.packagist（单数）、type 值必须显式指定为 "composer"、URL 必须是 HTTPS 且末尾带 /；项目 composer.json 中存在 repositories 字段会完全屏蔽全局配置；配置仅对执行用户生效，需确认实际运行用户并为其单独配置。
composer config -g repo.packagist 为什么没生效
命令执行无报错，但 composer install -vvv 日志里还是出现 packagist.org，说明配置根本没被读取——不是网络问题，是三个硬性条件漏了至少一个：
-
repo.packagist键名必须是单数，写成repos.packagist或packagist.org都静默忽略 - 中间的
composer是type值，不是可选参数，漏掉就 fallback 到官方源 - 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、报 Key does not exist，说明没写对。
项目里 composer.json 有 repositories 字段，镜像还生效吗
不生效。只要 composer.json 顶层存在 "repositories" 字段（哪怕只是 {} 或 []），全局配置 repo.packagist 就被完全跳过——不是优先级低，是彻底不读。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查方法：
composer config repo.packagist（不加-g），有输出说明项目自己写了；没输出才轮到全局 - 常见陷阱：
"repositories": {}这种空对象也会触发“禁用默认源”，导致所有包都找不到 - 已有私有源时，别直接用
composer config repo.packagist ...（它会全量覆盖），应手动编辑composer.json，确保"repositories"是数组，并把镜像条目放在首位，保留其他源
宝塔、CI 或 Docker 里换镜像还是卡住
因为全局配置只对执行命令的用户生效。宝塔后台以 www 用户运行，GitHub Actions 默认用 runner 用户，Docker 容器里可能是 www-data 或自定义用户——你本地 root 配的镜像，它们根本读不到。
- 确认实际执行用户：
whoami或查日志 UID - 给对应用户配：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本中避免混用用户：前面
sudo配置，后面普通用户跑composer install，配置不会继承 - 更稳妥的做法：进项目根目录，用
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g）写进composer.json，一劳永逸
换完镜像还是卡在 Resolving dependencies 或 Downloading
卡在 Resolving dependencies 和镜像无关——那是 Composer 在本地解析依赖约束，受 composer.json 里宽泛版本（如 "php": "^7.4 || ^8.0"）、大量 dev-main 分支或未锁定的 require-dev 拖累。
- 卡在
Downloading但域名仍是packagist.org：说明镜像没生效，回看前几条 - 卡在
Downloading且域名已变成mirrors.aliyun.com：先清缓存composer clear-cache，再删vendor/和composer.lock，最后composer install（不是update） - 下载中途报
Content-Length mismatch或hash not match：旧composer.lock记录的是官方源的 dist URL 和 hash，必须删 lock 文件重生成
