Composer config -g repo.packagist 命令总不生效的根本原因是命令书写错误：漏写-g、键名误为repos.packagist、URL末尾缺/，三者任一出错均静默回退官方源且不报错；必须严格满足repo.packagist（单数）、type值composer、HTTPS且结尾带/这三项硬性条件，并通过composer config -g repo.packagist输出完整JSON验证。
composer config -g repo.packagist 命令为什么总不生效
不是网络慢，是命令写错了——漏掉 -g、键名写成 repos.packagist、URL 少了末尾 /，三者任一出错都会静默走官方源，且完全不报错。Composer 2.x 内部硬编码只识别 repo.packagist（单数、全小写、无 s），写成 repos.packagist 或 packagist.org 都会存进无效字段。
验证是否写入成功，直接运行：composer config -g repo.packagist
输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象；如果为空、null 或报错，说明没配成功。
-
-g必须带上，否则只改当前项目composer.json，换目录就失效 -
composer是type值，不是注释，漏掉它就 fallback 到packagist.org - URL 必须 HTTPS 开头且以
/结尾，否则请求路径拼成/composerpackages.json直接 404
阿里云/腾讯云/华为云镜像地址怎么填才对
不同镜像地址格式差异明显，尤其华为云路径含 /repository/php/，不能直接套用阿里云模板。推荐直接复制粘贴执行（注意空格和斜杠）：
- 阿里云：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 腾讯云：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 华为云：
composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/composer/
清华旧镜像 https://packagist.phpcomposer.com 已下线，继续用会报 Could not resolve host 或 cURL error 60；中科大镜像现为 https://packagist.mirrors.ustc.edu.cn/，但同步延迟略高，日常开发优先选阿里云。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
项目级配置比全局更可靠，怎么安全追加
团队协作或 CI 环境里，全局配置容易被覆盖或权限错位（比如宝塔面板用 www 用户跑命令，但 -g 写的是 root 的配置），项目级配置可 Git 跟踪、行为一致。
进项目根目录后执行（注意不加 -g）：composer config repo.packagist composer https://mirrors.aliyun.com/composer/
它会自动合并到 composer.json 的 "repositories" 字段中，key 固定为 "packagist"。
- 前提是原
"repositories"是对象（如{"packagist": {}}），不是数组；如果是数组，命令会失败，需先手动转成对象格式 - 已有私有仓库配置时，别手动编辑
composer.json覆盖整个repositories字段，否则可能误删源 - 改完必须删掉项目里的
vendor/目录和composer.lock文件，再执行composer install（不是update）
换源后 still stuck at “Resolving dependencies”？
镜像只加速下载，不解决依赖解析慢的问题。如果你发现 composer update 卡在 Resolving dependencies 几十秒甚至几分钟，基本可以确定是本地环境或 composer.json 写法导致的：
- PHP 版本约束太宽，比如
"php": "^7.4 || ^8.0"，会让 Composer 尝试大量组合 - 大量未锁定版本的 dev 包（如
"monolog/monolog": "dev-main"） -
require-dev里塞了太多工具
换源后首次 composer install 若报 hash 校验失败，删掉 vendor 和 composer.lock 重来即可。真正容易被忽略的是：镜像地址必须与元数据接口和 ZIP 分发节点严格匹配，否则会报 Package not found 或 Signature mismatch。
