composer config -g repo.packagist 命令失效是因为必须同时满足三项硬性条件：键名严格为单数 repo.packagist、第二个参数必须显式写 composer（type值）、URL须为HTTPS且末尾带 /；任一不符即静默回退官方源，验证需输出完整 JSON 如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
新装系统后直接跑 composer install 卡在 “Loading composer repositories”，不是网络差，是默认源 https://packagist.org 根本连不上——必须配镜像，且三处硬性条件缺一不可，否则命令看似成功，实际静默回退官方源。
composer config -g repo.packagist 命令为什么总没反应
它不是“没反应”，而是漏了任意一项就直接失效，且不报错：
-
repo.packagist必须是单数，写成repos.packagist或repositories.packagist都无效 - 第二个参数
composer是type值，不是注释或可选描述，不能省略、不能替换成composer.org或空字符串 - URL 必须以
https://开头，且末尾必须带/：比如https://mirrors.aliyun.com/composer/✅，少斜杠就是 404（请求路径变成/composerpackages.json） - 必须加
-g，否则只改当前目录下的composer.json，换项目即失效
验证是否真写进去了，别信终端没报错
执行完命令后，唯一可信的验证方式是：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer config -g repo.packagist - 正确输出必须是完整 JSON 对象：
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 如果返回空、
null、Key "repo.packagist" does not exist，或只有一行 URL 字符串，说明配置根本没落盘，立刻重试 - Linux/macOS 下还要检查
~/.composer/config.json所属用户：ls -ld ~/.composer，权限不对就跑chown -R $USER ~/.composer - Windows 下确认用的是当前登录用户 CMD，别混用管理员和普通用户身份
CI/宝塔/Docker 环境里镜像不生效？用户权限不一致是根源
全局配置写在 %USERPROFILE%\AppData\Roaming\Composer\config.json（Windows）或 ~/.composer/config.json（Linux/macOS），但它只对当前 shell 用户生效：
- 宝塔后台用
www用户，GitHub Actions 用runner用户，Docker 容器里甚至没有~/.composer - 你用管理员 CMD 配的，开发时却是普通用户，配置压根读不到
- 最稳做法：进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 该命令会安全写入
composer.json的repositories字段，key 固定为"packagist"，Git 可提交，所有环境行为一致 - 注意：如果
composer.json里"repositories"是数组[]，命令会报错；需先手动改成对象{}再运行
换源后依然卡住？清缓存和旧文件是硬性步骤
镜像只加速元数据下载，但 Composer 会优先读取本地缓存和 composer.lock 中记录的旧地址：
- 先清缓存：
composer clear-cache - 删掉
vendor/和composer.lock - 再运行
composer install（不是update），否则旧 lock 文件里的 hash 可能和镜像元数据不匹配 - 最终验证方式：
composer install -vvv日志里出现https---mirrors-aliyun-com-composer这类域名才算真正生效
最容易被忽略的是：哪怕你把命令复制得一字不差，只要终端不是当前运行 Composer 的那个用户启动的，或者 PATH 没刷新，或者缓存没清，它就还是走官方源——这些环节没有容错，全靠手动对齐。
