composer config -g repo.packagist 无反应是因为键名必须为单数 repo.packagist、中间必须显式指定 composer 类型值、url 必须 https 且末尾带 /，三者缺一即静默忽略；验证需输出完整 json 对象，否则配置未生效。
composer config -g repo.packagist 为什么总没反应
命令执行后无报错、composer install照旧卡在 Loading composer repositories，本质不是网络问题，而是配置根本没写进去——Composer 对字段校验极严，错一个就静默忽略。
必须同时满足三个硬性条件：
-
repo.packagist是唯一合法键名：写成repos.packagist、packagist.org或大小写混用（如Repo.Packagist）全部无效 - 中间的
composer是强制type值：不能省略，也不能替换成vcs、package或空字符串 - 镜像 URL 必须是 HTTPS 且末尾带
/：例如https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/composerpackages.json导致 404 或 fallback 到官方源
验证是否真生效：运行 composer config -g repo.packagist，输出必须是完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或报 Key not found，说明配置失败。
全局配置 vs 项目级配置：什么时候该用哪一种
全局配置写进 ~/.composer/config.json，影响所有项目；项目级配置写进当前目录 composer.json 的 repositories 字段，只作用于本项目。选哪个取决于运行环境。
日常本地开发用全局最省事：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
但团队协作或 CI/CD 环境必须用项目级——GitHub Actions、宝塔面板、Docker 容器里的 Web 服务往往以 www 或 runner 用户运行，它们读不到你的个人 ~/.composer 配置。
项目级配置要小心两点：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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.json，确保镜像对象放在repositories数组首位，并显式禁用官方源：{"packagist.org": false}和镜像对象并列，不能嵌套
换源后还是卡在 Loading composer repositories 怎么办
镜像只改下载路径，不解决缓存和元数据残留问题。Composer 会优先读取本地缓存和 composer.lock 中记录的旧地址，哪怕你已配好新镜像，它仍可能发请求到 packagist.org。
必须连做三步才能真正切换成功：
- 运行
composer clear-cache清掉本地缓存 - 删掉项目下的
vendor/和composer.lock - 再执行
composer install -vvv，观察日志里是否出现mirrors.aliyun.com或mirro（注意截断字样），确认请求已走镜像
如果仍卡住，检查 PHP CLI 是否禁用了 proc_open 或 putenv：查 php.ini 中 disable_functions，删掉它们并重启 PHP-FPM/Apache/Nginx。
宝塔、Docker 等多用户环境怎么配才真正生效
全局配置 -g 默认写入当前 shell 用户的 ~/.composer/config.json，但在宝塔后台或 Docker 容器中，Web 服务通常以 www 用户运行，它根本看不到你终端用户的配置。
正确做法是切换用户执行：
- 宝塔环境下：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - Docker 构建时：在
Dockerfile中用USER www切换后再执行配置命令 - CI 脚本中（如 GitHub Actions）：不要依赖
-g，直接用项目级配置 +--repository-url参数临时指定，例如composer update --repository-url=https://mirrors.aliyun.com/composer/
还有一点容易被忽略：某些企业防火墙会拦截 HTTPS 请求，可临时试 http://mirrors.aliyun.com/composer/（仅调试，不可长期使用）；华为云镜像偶尔同步延迟略高，新包发布后几分钟内可能拉不到，阿里云或腾讯云更稳。
