composer config -g repo.packagist 总不生效是因为三个硬性条件缺一不可：键名必须为单数 repo.packagist、中间必须显式指定 type 值 composer、url 必须 https 且末尾带 /；任一不符即静默回退官方源，验证需输出完整 json 对象。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 抽风，而是三个硬性条件缺一不可：
- 键名必须是 repo.packagist（注意是 repo 单数，不是 repos 或 repositories.packagist.org）
- 中间必须带 composer 这个 type 参数：正确写法是 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，漏掉 composer 就 fallback 到官方源
- URL 必须是 HTTPS + 末尾带斜杠：https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌（少斜杠会拼出 /composerpackages.json 导致 404）
验证是否写入成功：运行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象；空、null 或仍是 https://packagist.org 都说明没生效。
全局配置 vs 项目级配置，该选哪个
全局配置看似省事，但实际在 CI、宝塔、code-server 等场景下极易失效——因为 composer config -g 写的是当前用户（如 root）的 ~/.composer/config.json，而构建进程常以 www 或 runner 用户运行，根本读不到。
项目级配置更可靠：
- 进入项目根目录后执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g）
- 它会自动在 composer.json 顶层添加或合并 "repositories" 字段，key 固定为 "packagist"
- 配置随代码提交，新人拉完即用，CI 每次构建都读取最新设置
- 若项目已有 "repositories": {}，手动编辑易因逗号、引号错位导致 JSON 解析失败，务必用命令操作
换镜像后还是卡在 downloading 或 Resolving dependencies
先分清卡在哪一阶段：
- 卡在 Downloading 或 Loading repositories：确实是镜像问题，检查缓存和连通性
• 必须执行 composer clear-cache，否则旧缓存里的元数据仍指向 packagist.org
• 手动测试镜像可用性：curl -I https://mirrors.aliyun.com/composer/packages.json，返回 200 才算通
• 若提示 SSL certificate problem，升级系统证书库：sudo update-ca-certificates（Debian/Ubuntu）或 sudo yum update ca-certificates（CentOS/RHEL）
- 卡在 Resolving dependencies：和镜像完全无关，是本地解析瓶颈
• PHP 内存不足（默认 128M 不够），临时加 COMPOSER_MEMORY_LIMIT=-1
• Xdebug 启用中会让解析慢 5–10 倍，用 php -d xdebug.mode=off $(which composer) install 临时禁用
• composer.json 中 PHP 版本约束太宽（如 "php": "^7.4 || ^8.0"）或 require-dev 塞了太多工具链，触发深度回溯
哪些镜像源现在真能用（2026 年实测）
清华源已关闭公共服务；腾讯云镜像同步延迟高、偶发 503；Laravel China、PHPComponer 等均已下线。
目前稳定可用的只有：
- 阿里云：https://mirrors.aliyun.com/composer/（推荐首选，同步及时、证书兼容性好，注意结尾斜杠不能少）
- 华为云：https://mirrors.huaweicloud.com/repository/php/（备选，内网穿透友好，注意不是 mirrors.huaweicloud.com 下的其他路径）
- 中科大镜像 https://mirrors.ustc.edu.cn/composer/ 理论上可用，但近期部分节点响应不稳定，建议优先试阿里云
验证是否真走镜像：加 -vvv 运行 composer install，日志里第一行 Downloading https:// 的域名必须匹配你配的镜像地址，比如 mirrors.aliyun.com
