composer config -g repo.packagist 总不生效是因为键名必须为单数 repo.packagist、中间必须显式传入 composer 作为 type 值、URL 必须 HTTPS 且末尾带 /，三者缺一即静默回退官方源；验证需输出完整 JSON 对象。
换镜像能解决 composer require 卡在 “Loading composer repositories” 或 “Downloading” 的问题，但 90% 的失败不是镜像不可用，而是配置写错、缓存残留或命令用错——它不会报错，只会静默 fallback 到官方源。
为什么 composer config -g repo.packagist 总不生效
这条命令有三处硬性要求，错一个就等于没配：
-
repo.packagist必须是单数，写成repos.packagist或packagist.org都无效 - 中间必须显式传入
composer作为 type 值：漏掉它，Composer 2.x 会直接回退到https://packagist.org - URL 必须是 HTTPS 且末尾带
/，比如https://mirrors.aliyun.com/composer/✅；少斜杠会拼成/composerpackages.json，返回 404
验证是否写入成功：composer config -g repo.packagist 输出应为完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果返回空、null 或仍是官方地址，说明根本没写进去。
composer require 还卡在 Resolving dependencies？和镜像无关
镜像只加速元数据拉取和 ZIP 下载，不改变依赖解析逻辑。这个阶段卡住，基本是约束太宽或环境不匹配：
-
"php": "^7.4 || ^8.0"这类宽松约束会让 Composer 尝试数百个版本组合 -
require-dev里没锁版本的包（如"phpunit/phpunit": "*"）会触发全量版本探测 - 本地 PHP 版本低于
composer.json中platform.php声明值，触发降级查找 - Xdebug 启用中会使解析慢 5–10 倍，临时禁用：
php -d xdebug.mode=off $(which composer) require foo/bar
项目级配置比全局更可靠，尤其在 CI 和团队协作中
CI 流水线、Docker 容器、宝塔面板跑的 composer 基本读不到你本地的 ~/.composer/config.json，因为用户权限不同。进项目根目录执行：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：不加 -g）
该命令会自动向 composer.json 的 repositories 字段追加 "packagist" 条目，不覆盖已有私有源。改完后务必删掉 composer.lock 和 vendor/，再跑 composer install ——不要用 update，否则 lock 文件仍记录旧源。
换源后仍出现 Could not find package 怎么办
这不是配置问题，而是镜像同步延迟或包未收录：
- 新发布的包通常需 5–10 分钟才能同步到阿里云镜像；可临时切腾讯云源验证：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 用
curl -I https://mirrors.aliyun.com/composer/packages.json检查 HTTP 状态码，必须是200 OK - 某些小众包只存在于 packagist.org，镜像未做全量同步，此时只能临时切回官方源：
composer config -g repo.packagist composer https://packagist.org
真正容易被忽略的是：换源之后必须清缓存（composer clear-cache），否则 Composer 仍从旧缓存加载元数据——这一步跳过，90% 的“换源无效”就出在这里。
