确认 composer 真正生效的镜像源需按优先级顺序验证：环境变量＞项目级 repositories＞全局 config＞默认源；执行 echo $composer_repo_packagist、composer config repo.packagist、composer config -g repo.packagist，并以 composer diagnose -v 末尾显示 https://repo.packagist.org 才算成功回退。
怎么确认当前真正生效的镜像源
别只跑 composer config -g repos.packagist 就以为完事了。Composer 实际请求源的优先级是：环境变量 > 项目级 composer.json 中的 repositories > 全局 config.json > 默认官方源。漏掉任何一层，都可能“看着清干净了，结果 install 还是从阿里云拉包”。
按顺序执行这三步验证：
- 查环境变量：
echo $COMPOSER_REPO_PACKAGIST（Linux/macOS）或echo %COMPOSER_REPO_PACKAGIST%（Windows），非空就得先清理 - 查项目级配置：
composer config repo.packagist（不加-g），它会合并环境变量和项目配置，返回真实生效地址 - 查全局配置：
composer config -g repo.packagist，注意是单数repo.packagist，不是repos.packagist（后者在 Composer 2.0+ 已被弃用，设了也不生效）
最可靠的终验方式是：composer diagnose -v，末尾出现 Checking https://repo.packagist.org/packages.json 才算真正回退成功。
删配置还是直接覆盖？选覆盖更稳
旧教程常教删字段，但 Composer 2.2–2.4 小版本在删掉 repos.packagist 后可能出现 fallback 失败、静默走错源，甚至报 Could not parse version constraint。而直接覆盖为官方地址，逻辑清晰、绕过所有分支判断，兼容所有 ≥2.0 版本。
执行这两条命令即可覆盖到位：
- 全局强制切回：
composer config -g repo.packagist composer https://packagist.org（必须带composer类型前缀，不能写成https://packagist.org或https://repo.packagist.org） - 仅当前项目临时切回：
composer config repo.packagist composer https://packagist.org（不加-g）
如果之前混设过 repo.packagist 和 repos.packagist，可先清理再覆盖：composer config -g --unset repo.packagist 和 composer config -g --unset repos.packagist。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
清缓存不是可选项，是硬性步骤
换源后不执行 composer clear-cache，Composer 仍会读取缓存里旧镜像的 packages.json 快照——结果就是 composer update 找不到新包、版本解析失败、锁文件更新异常，甚至报 Package not found 或 Failed to extract。
执行后验证是否清干净：
-
composer clear-cache（必须执行） - 检查缓存目录：
ls -la ~/.composer/cache/repo/（Linux/macOS）或dir %APPDATA%\Roaming\Composer\cache\repo\（Windows），应为空或只剩空子目录 - 若某包反复出错（如
guzzlehttp/guzzle），可手动清理对应路径：rm -rf ~/.composer/cache/files/guzzlehttp/guzzle
临时跳过缓存测试是否生效：composer install --no-cache -vvv 2>&1 | grep "GET https"，观察日志中 URL 是否为 https://repo.packagist.org。
项目级 repositories 字段最容易被忽略
很多人清完全局配置就以为结束了，但项目根目录下的 composer.json 里如果还留着 "repositories": [{...}]，它会完全屏蔽全局设置，且优先级最高。尤其注意两种常见残留格式：
- 数组形式：
"repositories": [{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}]—— 直接删整个repositories字段 - 对象形式：
"repositories": {"packagist.org": false}—— 这种禁用写法也得删，否则默认源不会自动启用
编辑前建议先备份：cp composer.json composer.json.bak；删完运行 composer validate 确保 JSON 格式合法。Windows 用户若遇到 Permission denied，大概率是杀毒软件锁了 %APPDATA%\Roaming\Composer\config.json，需管理员权限运行终端。
