Composer镜像配置无效主因是命令漏-g、键名错为repos.packagist、缺type值composer、URL末尾无/，四者缺一即静默回退官方源；还需检查项目级repositories是否覆盖及缓存是否清除。
配置 Composer 国内镜像后仍报错，绝大多数情况不是镜像本身不可用，而是配置没真正生效——Composer 2.x 会静默 fallback 到 https://packagist.org，不提示、不报错，只默默变慢或失败。
composer config -g repo.packagist 命令为什么总不生效
这条命令写错一个字符就等于没配。必须同时满足四个硬性条件：
-
repo.packagist是固定键名，不能写成repos.packagist、repositories.packagist.org或packagist - 必须加
-g（全局标志），漏掉就只改当前项目，不是全局 - 中间的
composer是 type 值，不是可选参数，也不能写成type: "composer"这种格式 - URL 必须是 HTTPS 且末尾带
/，例如https://mirrors.aliyun.com/composer/✅，少斜杠就会拼出/composer/packages.json导致 404
验证是否真写进去了：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null、报错、或只返回字符串，都说明没成功。
项目级 repositories 字段正在悄悄覆盖你的镜像
Composer 的源优先级是：项目级 composer.json 中的 repositories > 全局配置 > 默认源。哪怕你全局配对了，只要项目里有这个字段，它就直接屏蔽镜像。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查方式：
cd 项目目录 && composer config repo.packagist（不带-g），有输出就说明被覆盖 - 常见陷阱：
"repositories": []、"repositories": {}、甚至残留的"laravel-china.org"等已下线地址 - 安全清理：用
composer config --unset repositories删除整个字段，再重新配镜像；或者直接手动删掉composer.json里的repositories块
缓存没清，新配置就是白配
Composer 缓存的是元数据路径（比如 p/provider-2025-10%24.json）和 packages.json 快照。改了镜像但不清缓存，它仍按旧地址发请求，结果就是 404、找不到包、锁文件错乱。
- 必做动作：
composer clear-cache - 更彻底清理（尤其 Windows 用户）：
rm -rf ~/.composer/cache/repo/https---packagist.org/（Linux/macOS）或手动删%APPDATA%\Composer\Cache\repo\https---packagist.org\ - 验证是否清空：
ls -la ~/.composer/cache/应为空或只剩空子目录
镜像地址本身不可达，但 Composer 不告诉你
“Could not resolve host” 或 “Connection refused” 很可能只是 DNS 污染或镜像临时维护，而 Composer 不会自动切备用源，也不会提示你换。
- 先测通不通：
curl -sS https://mirrors.aliyun.com/composer/packages.json | head -n1，能返回 JSON 就说明服务正常 - 如果失败，立刻切备用镜像：
composer config -g repo.packagist composer https://repo.huaweicloud.com/repository/php/ - CI/宝塔等环境注意用户权限：root 配的全局配置对
www用户无效，得用sudo -u www composer config -g ...单独配
最常被忽略的一点：composer.lock 文件里存着旧源地址，哪怕镜像和缓存都对了，它仍会固执地去连 packagist.org。删掉 vendor/ 和 composer.lock 再重装，才是唯一可靠起点。
