composer全局配置写入失败主因是composer_home路径错配、项目级repositories字段屏蔽或镜像url缺末尾斜杠；需验证home路径、清缓存删lock/vendor、确保url为https且以/结尾。
COMPOSER_HOME 被覆盖导致全局配置写错位置
执行 composer config -g repo.packagist 后输出为空，不是命令错了，而是配置被写进了别人家目录。常见于 CI/CD、Docker 或宝塔环境：你用 root 配的，但 PHP 进程以 www-data 或 git 用户运行，它读的是自己家目录下的 ~/.composer/config.json。
验证方式：composer config --global home 输出的路径，必须和当前运行 Composer 的用户实际可访问的 $HOME/.composer 一致。若不一致，说明 COMPOSER_HOME 被显式设错或继承自父进程。
- Linux/macOS 下检查：
echo $COMPOSER_HOME，再确认该路径是否存在且可读写 - 宝塔面板中，PHP 执行脚本需在开头加：
export COMPOSER_HOME=/home/www/.composer - Docker 中避免用
sudo配置；应在构建阶段以目标用户身份执行composer config -g
项目级 repositories 字段静默屏蔽全局镜像
即使 composer config -g repo.packagist 输出正确 JSON，composer install -vvv 日志里仍出现 packagist.org 或 codeload.github.com —— 这是项目级 composer.json 中的 "repositories" 字段在作祟。Composer 的源优先级是：项目级 > 全局 > 默认源，没有协商，没有 fallback。
只要 composer.json 里存在 "repositories" 键（哪怕值是 []、{} 或 {"packagist.org": false}），全局镜像就彻底失效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 快速检查：
composer config repositories，看输出是否含https://repo.packagist.org - 定位硬编码：
grep -A5 '"repositories"' composer.json - 临时禁用：
composer config --unset repositories（注意无-g）
镜像 URL 缺少末尾斜杠引发 404 并静默回退
配置命令里漏掉 URL 末尾的 /，比如写成 https://mirrors.aliyun.com/composer，Composer 会拼出错误路径 /composerpackages.json，返回 404，然后安静切回官方源——不报错、不提示、日志里也只显示 “Could not fetch”。
真实生效的 URL 必须带 trailing slash，且协议为 HTTPS：
- ✅ 正确：
https://mirrors.aliyun.com/composer/ - ❌ 错误：
https://mirrors.aliyun.com/composer（少/） - ❌ 错误：
http://mirrors.aliyun.com/composer/（非 HTTPS） - 直接验证：
curl -I https://mirrors.aliyun.com/composer/packages.json，必须返回200 OK
缓存残留让“新镜像”仍在读旧元数据
换镜像后跑 composer install 依然卡住或报错，不是镜像没生效，而是 Composer 在用缓存里的旧 packages.json 和旧 composer.lock 做决策。
composer clear-cache 只清 ZIP 和部分 JSON，但关键的包元数据默认缓存 15 分钟，且 composer.lock 里每个包的 dist.url 是硬编码地址，不会随镜像自动更新。
- 必须三步一起做：
composer clear-cache→ 删除vendor/→ 删除composer.lock - 重装时加
--no-cache参数：例如composer install --no-cache - CI 环境尤其要注意：不能只依赖本地缓存清理，每次构建都应从干净状态开始
COMPOSER_HOME 路径、项目 composer.json 中不存在任何 repositories 字段、镜像 URL 的每个字符（包括末尾斜杠）都精确匹配服务端要求。少一个条件，Composer 就会沉默地退回 packagist.org。
