最稳最快改全局镜像源的方式是运行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，仅修改配置、不碰缓存、不编辑json、立即生效，且兼容1.x/2.x；url必须以/结尾，windows需重启终端，项目级配置优先级高于全局，验证需清缓存并检查实际请求域名。
改源不是改 composer.json，而是用 composer config 写配置；项目级和全局配置优先级不同，不清理缓存或没关 packagist.org 就算写了也白写。
用 composer config 改源才是唯一可靠方式
Composer 不读取 composer.json 里的镜像地址——它只从配置文件（~/.composer/config.json 或项目级 composer.json 的 repositories 字段）加载源。手动编辑 composer.json 加 "repositories" 数组，本质是项目级配置，但必须带 "type": "composer"，否则报 Invalid repository type: composer。
- 全局改（所有项目生效）：
composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}' - 项目级改（仅当前目录生效）：
composer config repositories.packagist.org '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}'（去掉-g） - 别用
repo.packagist（旧写法）、mirror（官方不识别）、repos.packagist（多一个 s，部分版本报错） - URL 必须以
/结尾，且不能带/packages.json，否则请求 404
为什么改了还是走 packagist.org
常见原因不是命令错了，而是配置被覆盖或未禁用默认源：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 项目根目录有
composer.json，且含"repositories"字段 → 项目级配置优先级高于全局，直接屏蔽全局设置 - 没显式关闭
packagist.org→ 即使写了国内镜像，Composer 仍会 fallback 到官方源查包，导致Could not find package或装错版本 - 执行了
sudo composer config -g（Linux/macOS）→ 配置写进 root 用户的config.json，普通用户运行时读不到 - Windows 下改完没重开终端 → 环境变量未刷新，仍读旧配置
必须清缓存 + 验证真实请求 URL
Composer 缓存的是仓库元数据（如 packages.json），不是下载包本身。--no-cache 只跳过 zip 包缓存，不解决源地址失效问题。
- 清缓存：运行
composer clear-cache（推荐），或手动删~/.composer/cache/repo/https---mirrors.aliyun.com-composer/ - 删
composer.lock和vendor/：旧 lock 文件里硬编码了包地址，不删会绕过新镜像 - 验证是否真走镜像：运行
composer update -vvv，搜索日志中的GET行，确认 URL 是https://mirrors.aliyun.com/composer/p2/xxx.json，不是https://packagist.org/
dist 地址也要配，否则 zip 包仍从国外拉
元数据走镜像 ≠ 实际 zip 包也走镜像。阿里云等镜像服务对 dist 的支持是独立的，不额外配置，require 或 update 时仍可能从 GitHub 或 packagist.org 下载压缩包，导致慢或失败。
- 需在配置中加 dist-mirror 映射（部分镜像支持，如阿里云）：
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/后，再补一句：composer config -g github-protocols https - 更稳妥做法：用
composer install --prefer-dist并观察 -vvv 日志里 dist 的url字段是否指向镜像域名 - 如果看到
Downloading https://api.github.com/...，说明 dist 没走镜像，得检查镜像文档是否支持 dist 重定向
