composer config -g repo.packagist 命令总不生效是因为必须同时满足三个硬性条件：键名必须为单数 repo.packagist（不能多s）、中间参数必须显式写 composer（type值）、URL必须HTTPS且末尾带 /；任一缺失即静默回退官方源，验证需输出完整JSON对象。
composer config -g repo.packagist 命令为什么总不生效
不是镜像地址挂了，也不是网络卡，而是命令本身写错了三个硬性条件，Composer 就会静默忽略、不报错、不提示、也不写入配置——你执行完以为成功了，其实还在连 packagist.org。
必须同时满足：
-
repo.packagist是唯一合法键名：不能写成repos.packagist（多一个 s）、packagist.org或mirror - 中间的
composer是强制 type 值，不是可选项：漏掉它，命令就失效 - URL 必须是 HTTPS 且末尾带
/：比如https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/composerpackages.json导致 404
验证是否真写进去了：运行 composer config -g repo.packagist。输出必须是完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果返回空、null、或报 Key does not exist，说明没写对，立刻重试。
项目级配置覆盖全局设置怎么办
只要项目根目录的 composer.json 里有 repositories 字段，全局镜像就自动失效——这是 Composer 的设计逻辑，不是 bug。
常见陷阱：
- 哪怕
"repositories": {}这种空对象，也会触发“禁用默认源”，全局镜像完全不走 -
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g）会全量替换整个repositories字段，把你原有的私有 Git 源（如"my-private": {"type": "vcs", ...}）直接清空 - 宝塔、GitHub Actions、Docker CI 默认以
www或runner用户运行，根本读不到你本地$USER的全局配置
安全做法：手动编辑 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 install 报 hash 不匹配
这不是网络问题，是旧 composer.lock 文件里记录的包哈希和 dist URL 来自官方源，切换镜像后，Composer 仍按原路径去阿里云找 zip 包——但镜像服务的内部路径映射与 packagist.org 不同，校验必然失败。
必须做两件事：
- 删掉项目里的
vendor/目录 - 删掉
composer.lock文件
再执行 composer install（不是 update），否则旧 lock 文件仍指向旧源地址。
宝塔或 CI 环境里全局配置为啥不起作用
全局配置写在 ~/.composer/config.json，但它只对「执行命令的用户」生效。宝塔「一键部署」、PHP 管理器、计划任务默认以 www 用户运行，而你在终端用 root 执行的 composer config -g 写进了 /root/.composer/config.json，www 根本读不到。
解决方法很直接：
- 先确认实际执行用户：在宝塔终端运行
whoami，或查日志里的 UID - 给对应用户单独配：比如是
www，就执行sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本中，确保
composer config -g和后续composer install使用同一用户（常见错误是前面用sudo，后面普通用户跑）
别指望 sudo composer config -g 后普通用户能继承配置——Composer 不跨用户共享配置。
