命令没生效是因为未满足三要素：键名必须为repo.packagist（非repos）、type值必须显式写composer、URL须为以/结尾的HTTPS地址，缺一则静默回退至packagist.org。
composer config -g repo.packagist 命令为什么没生效
90% 的配置失败不是网络问题，而是命令写错三个硬性条件，且 Composer 会静默 fallback 到 https://packagist.org，不报错也不提示。
-
repo.packagist键名不能写成repos.packagist（多一个 s）或packagist.org（缺repo.前缀） - 中间的
composer是type值，不是注释或可选参数——漏掉它，Composer 2.0+ 直接忽略配置 - URL 必须是 HTTPS，且末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致拼出/packages.json路径，返回 404）
验证是否写入成功：运行 composer config -g repo.packagist。输出应为完整 JSON 对象（如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}），或至少是镜像 URL 字符串。空、null、报错或仍显示 https://packagist.org，说明没生效。
项目级配置比全局更可靠，尤其在 CI/CD 和团队协作中
全局配置写在 /root/.composer/config.json，只对当前用户生效。宝塔面板默认以 www 用户执行，GitHub Actions 用 runner 用户，它们根本读不到你的 root 配置。
- 进项目根目录后执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：不加-g） - 该命令会自动向
composer.json的repositories字段追加"packagist"条目，不覆盖已有私有源 - 如果
composer.json原本是"repositories": {}，命令会转为标准数组并插入；如果是"repositories": []，则追加到数组末尾 - 切勿手动编辑 JSON——格式错一个逗号或引号，
composer install就直接报错
改完后必须删掉 vendor/ 和 composer.lock，再跑 composer install --no-cache。旧 composer.lock 记录的是官方源的包哈希，和镜像元数据不兼容，必然触发 hash does not match。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
换源后仍卡在 Resolving dependencies 或 Downloading？这不是镜像的问题
镜像只加速元数据拉取和 ZIP 包下载，不解决依赖解析慢或缓存污染问题。
-
Resolving dependencies卡住几十秒？检查composer.json是否写了过宽的 PHP 版本约束（如"php": "^7.4 || ^8.0"），或大量dev-main未锁定分支 -
Downloading卡住？先执行composer clear-cache，再删vendor/和composer.lock—— 否则 Composer 优先读旧缓存，根本不会发请求到镜像域名 - 验证是否真走镜像：运行
composer show monolog/monolog -vvv 2>&1 | grep "Downloading"，日志里必须出现mirrors.aliyun.com或mirrors.cloud.tencent.com - 别关
packagist.org回退机制：composer config -g repos.packagist false会让缺失包直接失败，而新版 Composer 默认在镜像 404/503 时自动兜底
临时换源调试与多镜像场景处理
CI 脚本、临时测试或团队尚未统一镜像时，用 --repository 参数最安全，优先级高于全局和项目配置。
- 示例：
composer create-project laravel/laravel myapp --repository=https://mirrors.tuna.tsinghua.edu.cn/composer/ - 加
-vvv可直接看到实际请求 URL：composer update -vvv --repository=https://mirrors.cloud.tencent.com/composer/ - 如果项目已存在私有仓库（如内部 GitLab 源），别手动覆盖
repositories数组——用composer config repo.packagist命令追加，确保私有源仍在数组中 - 华为云镜像地址是
https://mirrors.huaweicloud.com/repository/php/，注意路径结构不同，不是/composer/结尾
镜像同步延迟通常在 5 分钟内，阿里云镜像页底部有“最后更新时间”可查。遇到某个新包找不到，先确认是否刚发布不足一小时，而不是急着换源或关回退。
