Composer config -g repo.packagist 不生效的根本原因是三个硬性条件任一缺失：键名必须为单数 repo.packagist（非 repos）、type 参数必须显式指定为 composer、URL 必须以 / 结尾且为 HTTPS。
别搭全量镜像——你作为开源项目贡献者，真正需要的是一套能快速验证 PR 是否破坏依赖兼容性的轻量测试环境，而不是同步几百万包的镜像服务。
composer config repo.packagist 命令为什么总不生效
不是网络卡，是三个硬性条件漏掉任一就静默失败：
-
repo.packagist不能写成repos.packagist（多一个s就完全被忽略） - 必须显式写出
composer这个type值，命令里缺它等于没配 -
url必须是 HTTPS，且末尾带/，例如https://mirrors.tuna.tsinghua.edu.cn/composer/；少斜杠会拼出/composerpackages.json导致 404
验证是否生效，只看这一行输出：composer config -g repo.packagist。返回空、null 或报错，说明配置没落进正确位置。
项目级配置为什么更适合 PR 测试
你在 fork 的仓库里改代码、提 PR，CI 流水线跑的是干净容器，全局配置根本不可控。项目级配置直接写进 composer.json，Git 可追踪、CI 可复现：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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.tuna.tsinghua.edu.cn/composer/（注意：不加-g） - 这条命令会自动在
composer.json的repositories字段里插入或合并"packagist"条目，不覆盖你已有的私有源 - 改完必须删掉
vendor/和composer.lock，再跑composer install—— 否则 Composer 仍按旧 lock 文件里的 dist URL 下载，镜像形同虚设
为什么换源后 still stuck at Resolving dependencies
镜像只加速包文件下载（.zip/.tar），不参与依赖解析。卡在 Resolving dependencies，说明问题出在：
- 你的
composer.json里写了模糊约束（如"^2.0 || ^3.0"），Composer 要遍历大量版本元数据 - 镜像同步滞后，某个 provider 文件（如
provider-laravel~10.0.json）还没生成，导致反复重试 - 你用了
repositories数组但没禁用packagist.orgfallback，Composer 在镜像查不到时仍会去官方源兜底，超时后才报错
解决办法：在 repositories 里加一行 {"packagist.org": false}，并确认该对象是数组里的独立项，不是字段值。
真要搭本地可复现测试镜像，Satis 是唯一合理选择
你不需要实时同步 packagist.org，只需要把当前 PR 涉及的几个包（比如 monolog/monolog、your-forked/package）打包成静态索引，供 CI 或本地快速验证：
- 写最小
satis.json，只列 PR 中修改过的仓库：{"type":"vcs","url":"https://github.com/yourname/monolog"} - 运行
php bin/satis build satis.json web/，输出纯静态文件（packages.json+dist/*.zip） - 用 Nginx 指向
web/目录，然后在测试项目中配："repositories": [{"type":"composer","url":"http://localhost:8080/"}]
注意：satis 不支持动态版本匹配（如 dev-main），所有要测的分支必须提前打 tag 或明确指定 commit-ref；它也不处理签名验证，仅用于功能连通性验证。
