composer config -g repo.packagist 总不生效是因为必须同时满足三个硬性条件：键名必须为单数 repo.packagist，中间必须显式指定 composer 作为 type 值，URL 必须 HTTPS 且末尾带 /；任一不符即静默回退官方源，且不报错。
配置不生效不是镜像站问题，是 composer config -g repo.packagist 命令本身写错了——三个硬性条件缺一即静默回退官方源，且完全不报错。
为什么 composer config -g repo.packagist 总是没反应
它根本不是“执行完就生效”，而是必须同时满足三项校验，漏一个就当配置不存在：
-
repo.packagist必须是单数形式，写成repos.packagist、repositories.packagist或packagist.org全部无效，Composer 直接忽略整行 - 中间的
composer是type值，不是注释或可选项，省略或替换成https、vcs等都会导致 fallback - URL 必须以
https://开头，且末尾带斜杠：https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/composerpackages.json返回 404 - 必须加
-g，否则只改当前目录下的composer.json，换项目即失效
验证是否真写进去了？别信终端输出“OK”，只看这一行：composer config -g repo.packagist。正确结果必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或提示 Key "repo.packagist" does not exist，说明全白配了。
全局配置在宝塔、CI、Docker 里为什么还是走官方源
因为全局配置只写进当前用户的 ~/.composer/config.json（Windows 是 %APPDATA%\Composer\config.json），而这些环境用的是别的用户身份运行命令：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 宝塔后台默认用
www用户，你用普通 CMD 配的配置它读不到 - GitHub Actions 默认用
runner用户，sudo composer config -g可能写进了root的路径 - Docker 容器里往往没有
~/.composer，或者用户是www-data、app等非 root 身份
最稳的做法：进项目根目录（确保有 composer.json），执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g）。它会自动往 composer.json 的 repositories 字段安全追加，Git 可提交，所有环境行为一致。
换源后仍卡在 “Loading composer repositories” 怎么快速定位
这不是镜像地址问题，而是 Composer 还在用旧缓存或旧 composer.lock 文件里的 dist URL：
- 先清缓存：
composer clear-cache - 再删掉本地缓存目录：
rm -rf ~/.composer/cache/repo/https---packagist.org/（Linux/macOS）或%APPDATA%\Composer\Cache\repo\https---packagist.org\（Windows） - 检查项目级配置是否覆盖了全局：
cat composer.json | grep -A5 "repositories"，确认没残留"packagist.org": false或已下线域名（如laravel-china.org） - 删掉
vendor/和composer.lock，然后只跑composer install（不是update），让 Composer 从头解析依赖、生成适配新镜像的 lock 文件 - 临时验证是否走镜像：
composer install -vvv 2>&1 | grep -i "mirrors.aliyun"，没输出就说明流量还在直连海外
Windows 下 PATH 和用户权限双重陷阱
全新 Windows 系统常卡在这两步，不是镜像问题，是环境没对齐：
- 安装 Composer 时没勾选 Add to PATH（新版默认不勾），导致
composer --version找不到命令；手动把C:\ProgramData\ComposerSetup\bin加进系统环境变量后，必须新开 CMD/PowerShell 才生效 - 全局配置写在
%USERPROFILE%\AppData\Roaming\Composer\config.json，但宝塔、计划任务、Docker 容器里跑的composer很可能用的是www或runner用户，根本读不到你的配置 - 用管理员 CMD 执行
composer config -g，但日常开发是普通用户，配置写到了root的路径下，普通用户运行时完全不可见
真正容易被忽略的是：配置写进去了 ≠ 当前进程能读到。多用户、容器、Web 后台这些场景下，“谁在运行命令”比“怎么配”更重要。
