composer config -g repo.packagist 命令总不生效是因为键名必须为单数repo.packagist、type值必须显式写composer、url必须以/结尾，三者缺一即静默失效且不报错。

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

不是镜像地址失效，而是键名、type 或 URL 格式错得“静默失败”——composer config -g 不报错，但配置根本没写进去。

• repo.packagist 是唯一合法键名：写成 repos.packagist（多一个 s）、packagist.org 或大小写混用（如 Repo.Packagist）都会被忽略
• composer 是强制 type 值：不能省略，也不能写成 vcs、package 或空字符串
• 镜像 URL 必须以 / 结尾：https://mirrors.aliyun.com/composer/ ✅，少斜杠会拼出 /composerpackages.json 导致 404 或 fallback 到官方源
• 验证是否写入成功：运行 composer config -g repo.packagist，输出应为完整 JSON：{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}；如果为空、null 或报错，说明没写对

全局配置 vs 项目级配置，该选哪个

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

Discussion 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://mirrors.aliyun.com/composer/ 最快最稳
• 团队协作或 CI/CD 必须用项目级：避免成员本地配置不一致，且环境干净可控；命令是去掉 -g：composer config repo.packagist composer https://mirrors.aliyun.com/composer/
• 项目级配置必须满足三要素：写在 composer.json 的 repositories 数组首位、type 为 composer、URL 以 / 结尾；还要显式禁用官方源：{"packagist.org": false} 需和镜像对象并列放在数组里，不能嵌套
• 注意：composer config repo.packagist 会**完全覆盖**整个 repositories 字段，已有私有仓库配置会被清空

配完镜像还是慢或报错，下一步查什么

镜像只是改下载路径，真卡住往往不是源的问题，而是底层环境或缓存干扰。

• 检查 PHP 禁用函数：proc_open 和 putenv 必须启用；查 php.ini 中 disable_functions，删掉它们，然后重启 PHP-FPM 或 Apache/Nginx
• 确认扩展已加载：php -m | grep -E 'openssl|zlib'，缺一不可
• 删缓存再重装：composer clear-cache，再删 vendor 和 composer.lock，最后跑 composer install
• 验证实际走哪个源：composer diagnose 看 “Repo” 行；或加 -vvv 跑 composer update，日志里出现 mirrors.aliyun.com 才算真正生效
• composer.lock 里可能硬编码了旧 dist 地址，导致仍连 github.com 或 packagist.org；此时需 composer update --lock 刷新锁文件

临时换镜像或回退官方源怎么操作

不需要改配置文件，命令行参数优先级最高，适合排查、测试或 CI 脚本。

• 临时指定镜像：composer install --repository-url=https://mirrors.tencent.com/composer/，它会覆盖全局和项目级配置
• 注意：--repository-url 只对 install 和 update 生效，require 加这个参数无效
• 恢复官方源：composer config -g --unset repos.packagist；别手写删 ~/.composer/config.json，容易 JSON 格式错误
• 如果项目级配置已写死，--unset 不影响它；要清项目级，得手动删 composer.json 里的 repositories 字段，再 composer clear-cache

配镜像最麻烦的不是命令本身，而是“看起来配好了，其实没生效”，尤其 composer.lock 缓存、PHP 环境限制、JSON 格式细节这三处，最容易漏查。