composer config -g repo.packagist 输出为空或异常说明配置未写入，主因是漏-g、键名错（如repos.packagist）、url缺/或项目级repositories字段覆盖；须输出完整json并清缓存、删lock与vendor验证。
composer config -g repo.packagist 输出异常或为空
说明全局镜像配置根本没写进去，后续所有换源操作都白搭。常见原因包括命令漏了 -g、字段名写错（比如写成 repos.packagist 多了个 s）、JSON 格式不合法（少引号、逗号错位）。
执行以下三步验证：
- 运行
composer config -g repo.packagist，必须返回完整 JSON，如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 若报错或输出
null，立刻重设：composer config -g repo.packagist '{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}' - 注意 URL 末尾必须带斜杠
/，否则拼接packages.json时路径非法，导致 404
项目级 composer.json 里的 repositories 字段干扰全局配置
只要 composer.json 里存在 "repositories" 字段（哪怕只是空数组 []），Composer 就会彻底忽略 config -g 的设置，直接 fallback 到 packagist.org——这是静默失效最常被忽略的点。
检查并清理：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
grep -n '"repositories"' composer.json确认是否存在 - 临时注释或删除整段
"repositories": [...]，再试composer install - 如确需私有源，应确保其
type和url正确，且url可被curl -I直接访问返回 200
换源后仍卡在 packagist.org 或报 Connection refused
不是网络问题，是旧缓存和 lock 文件还在用老地址。Composer 会复用 composer.lock 里硬编码的 provider URL，不清除它，换源等于没换。
必须同步执行：
-
composer clear-cache—— 清掉本地 provider 元数据缓存 -
rm -f composer.lock vendor/——composer.lock不删，install仍按旧地址拉包；vendor/不删，残留文件可能权限混乱 - 再跑
composer install -vvv 2>&1 | grep -i "host\|mirrors"，第一行显示的域名才是真实请求目标
composer install 报 Permission denied 写 vendor/ 或 cache/
90% 是所有权错配，不是权限位（755/777）问题。尤其在 Docker、CI 或 sudo 过安装后，vendor/ 或 ~/.composer/cache/ 可能属于 root，而当前用户无权覆盖。
定位与修复：
- 查属主：
ls -ld vendor/ composer.lock和ls -ld $(composer config --global cache-dir) - 确认当前用户：
whoami和id -u - 精准修复：
sudo chown -R $USER:$USER vendor/ composer.lock $(composer config --global cache-dir) - 切忌
sudo composer install——它会让部分子目录变成 root 所有，后续update可能只失败一半，只能全删重来
composer.lock 和查 repositories 字段。这两步一漏，其他动作全在原地打转。
