composer config -g repo.packagist 命令必须严格满足三要素：键名是 repo.packagist（非 repos 或 repositories）、type 值显式写为 composer、url 用 https 且末尾带斜杠，否则静默失效。
composer config -g repo.packagist 命令必须写对三要素
配阿里云或华为云镜像，最常卡在“明明执行了命令却没提速”。根本原因不是网络，而是 composer config -g repo.packagist 这条命令漏掉或写错三个硬性条件：
-
repo.packagist不能写成repos.packagist或repositories.packagist—— 多一个s就完全不生效，且无任何提示 -
composer必须作为type值显式传入，不能省略：正确是composer config -g repo.packagist composer https://...，少掉中间那个composer，旧版 Composer 会静默回退到 packagist.org - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（缺斜杠会导致部分 2.2+ 版本请求/packages.json时 404，然后 fallback）
验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，例如：
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}空、null、报错或只返回 URL 字符串，都说明没写进去。
华为云镜像 URL 和阿里云不兼容，别混用
华为云镜像地址是 https://repo.huaweicloud.com/repository/php/，和阿里云的 https://mirrors.aliyun.com/composer/ 结构不同——前者路径含 /repository/php/，后者是 /composer/。两者不能互换，也不能拼错：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用华为云时，命令必须是：
composer config -g repo.packagist composer https://repo.huaweicloud.com/repository/php/ - 把华为云地址里的
/repository/php/替换成/composer/会 404 - 反过来，把阿里云地址改成
/repository/php/同样失败 - 两者都支持 HTTPS 和末尾斜杠，但同步策略、CDN 节点、响应延迟略有差异；华东用户通常阿里云更快，华南或华为云生态内项目可优先试华为云
项目级配置比全局更可靠，尤其在 CI/多用户环境
全局配置写在 ~/.composer/config.json，只对当前用户生效。但在宝塔、Jenkins、systemd 服务中，实际执行 composer install 的用户往往是 www、jenkins 或 root，而非你登录 shell 的账户——这就导致“你配好了，但 CI 拉不到镜像”。
- 进项目根目录后运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 该命令会直接修改
composer.json的repositories字段，key 固定为"packagist"，不能起别名 - 已有私有源（如 Git 类型）时，这条命令会**全量替换**整个
repositories对象，不是追加；需手动编辑composer.json，确保"packagist": { ... }是其中一项，并保留其他源 - CI 脚本中推荐直接用临时参数：
composer install --repository-url=https://mirrors.aliyun.com/composer/，彻底绕过配置文件依赖
换源后 vendor 和 composer.lock 必须重来
镜像只是加速下载，不改变包内容本身。但不同镜像源返回的 packages.json 可能因缓存或同步时间差，导致 hash 校验失败。
- 首次用新镜像执行
composer install或composer update时，如果报Invalid package information或 hash mismatch，不要硬等或改锁文件 - 直接删掉
vendor/目录和composer.lock文件，再重新运行composer install -
composer clear-cache也有必要，尤其之前用过多个镜像源，本地缓存可能混杂 - 注意：
composer update卡在Resolving dependencies阶段，和镜像无关——那是依赖图解析慢，得查composer.json冲突或版本约束问题
镜像配置本身很简单，但细节决定成败：URL 少个斜杠、type 漏写、用户权限错位、锁文件残留——这些地方一错，提速就成空谈。动手前先确认执行用户和输出 JSON，比反复重试更省时间。
