composer配置国内镜像必须同时满足四项：键名repo.packagist（非repos）、含-g参数、中间type值为composer、url以https://开头且末尾带/，缺一即静默回退官方源；验证需输出完整json对象{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
不配国内镜像，composer update 卡在 “Loading composer repositories” 或反复重试 https://packagist.org，不是你本地慢，是根本连不上——必须换源，且三处细节错任何一处都会静默失效。
为什么 composer config -g repo.packagist 总是没反应
这条命令不报错、不提示，但实际没写进去，90% 是因为漏了以下任意一项：
-
repo.packagist键名不能写成repos.packagist（多一个s就完全忽略） - 中间的
composer是type值，不是可选参数：正确写法是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，漏掉composer就 fallback 回官方源 - URL 必须以
https://开头，且末尾带斜杠：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致请求路径拼成/composerpackages.json，直接 404）
验证是否生效，只看这一行输出：composer config -g repo.packagist。返回 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 才算成功；返回空、null、或仍是 https://packagist.org，说明配置根本没进去。
宝塔、CI、Docker 里换源后还是卡住
全局配置写在当前用户的 ~/.composer/config.json，但宝塔「一键部署」默认用 www 用户，GitHub Actions 用 runner，Docker 构建常以 root 或非交互用户运行——它们读不到你本地终端配的镜像。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先确认真实执行用户：
whoami或查日志 UID - 给对应用户重配：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本中别依赖全局配置，改用临时参数更可靠：
composer install --repository-url=https://mirrors.aliyun.com/composer/
项目级配置怎么安全加镜像，又不破坏私有源
已有 repositories 字段时，手动编辑 composer.json 极易引号漏写、逗号错位、方括号不闭合。最稳妥做法是让 Composer 自动合并：
- 进项目根目录（有
composer.json的地方），执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：不加-g） - 如果原
"repositories": {}是空对象，命令会自动转为数组并追加 packagist 条目 - 如果原
"repositories": []是空数组，命令会向数组末尾插入新项，不会清空已有私有源 - 务必同时在
composer.json根节点加"packagist.org": false（不是放在repositories里），否则仍可能 fallback 到官方源
改完删掉 vendor/ 和 composer.lock，再跑 composer install——旧 lock 文件里的哈希和镜像元数据不匹配，会导致校验失败或下载路径错误。
composer update 还卡在 Resolving dependencies？那和镜像无关
镜像只加速元数据加载（packages.json）和 tarball 下载，不影响依赖解析逻辑。
- 如果卡在
Resolving dependencies阶段几十秒甚至几分钟，大概率是composer.json中版本约束太宽（如"^2.0"）、PHP 版本冲突、或已有composer.lock与当前 require 不兼容 - 加
-vvv看具体卡在哪条规则，不是网络问题，不用换源 - 首次用新镜像执行
composer install若报 hash 不匹配，删vendor/和composer.lock重来最稳妥
真正容易被忽略的是：镜像同步有延迟，阿里云、腾讯云通常滞后 5–30 分钟，尤其小众包或刚发版的 dev-main 分支。遇到 Could not find package xxx，先去 https://mirrors.aliyun.com/composer/packagist/ 搜一下，别急着怀疑配置。
