根本原因是键名必须为单数repo.packagist、type值必须显式写composer、url必须https且末尾带/，三者缺一即静默失效；验证需输出完整json对象{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。

composer config -g repo.packagist 为什么总不生效

根本原因不是网络或镜像地址失效，而是命令写错后 Composer 静默忽略——不报错、不提示，但配置压根没写进 ~/.composer/config.json。

必须同时满足三个硬性条件：

• repo.packagist 是唯一合法键名（repos.packagist、packagist.org、Repo.Packagist 全部无效）
• 第二个参数 composer 是强制 type 值，不能省略，也不能写成 vcs 或空字符串
• URL 必须以 / 结尾，且协议为 https://：例如 https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌（少斜杠会拼出 /composerpackages.json 导致 404）

验证是否写入成功，只看这一条命令输出：composer config -g repo.packagist。正确时返回完整 JSON：{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}；如果为空、null 或仍显示 https://packagist.org，说明没写进去，立刻重试。

全局配置 vs 项目级配置怎么选

全局配置写进 ~/.composer/config.json，影响所有项目；项目级配置写进当前目录的 composer.json 的 repositories 字段，只作用于本项目。

日常开发用全局最省事：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

团队协作或 CI/CD 必须用项目级，避免环境不一致：

• 在项目根目录运行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g）
• 该命令会自动向 composer.json 的 repositories 数组首位插入镜像对象
• 必须显式禁用官方源：{"packagist.org": false} 要和镜像对象并列放在数组里，不能嵌套
• 注意：composer config repo.packagist 会**完全覆盖**整个 repositories 字段，已有私有仓库配置会被清空

配完还是慢或报 could not find package 错误

镜像只是改下载路径，卡住大概率不是源的问题，而是缓存或 lock 文件残留。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

先确认镜像是否真正命中：

• 执行 composer install -vvv 2>&1 | grep -i "packagist.org"，日志里只要出现这个域名，说明还在直连海外
• 新建空文件夹，运行 composer require monolog/monolog，卡在 Downloading 超过 30 秒，基本可判定镜像未生效
• 临时绕过所有配置验证：composer install -r https://mirrors.aliyun.com/composer/

配完必须做两件事：

• 删掉 vendor/ 和 composer.lock（composer update 不行，得用 install）
• 执行 composer clear-cache，否则旧包元数据仍从缓存读取

如何查当前生效的镜像源

Composer 不靠 composer show 或 composer diagnose 查镜像，它只读配置项，优先级是：项目 composer.json > 用户 config.json > 默认源。

查全局配置：composer config --global repos.packagist.org

查项目配置：composer config repos.packagist.org

想一次性看全（含注释）：composer config --list | grep repositories，重点关注 repositories.packagist.org.url 这一项。

临时切回官方源调试，不用删配置：composer update --repository=https://packagist.org；临时清空项目镜像：composer config --unset repos.packagist.org（注意：全局镜像未 unset 时，项目 unset 后仍继承全局）