Composer镜像配置未生效的主因是键名必须为单数repo.packagist、type值必填composer、URL须HTTPS且末尾带/，三者缺一即静默回退官方源；验证需输出完整JSON对象。
独立开发者配 Composer 镜像，最常踩的坑不是不会配，而是配了却没生效——命令看着对，composer install 还是卡在 Loading composer repositories，根本没走镜像。问题往往出在三个地方：键名写错、type 值漏掉、URL 少了个 /。
为什么 composer config -g repo.packagist 总是“配了但没用”
这条命令静默失败率极高，不报错也不提示，但实际根本没写进配置。验证方式只有一种：composer config -g repo.packagist 必须输出完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果返回空、null、报 Key "repo.packagist" does not exist，或者只有一行 URL 字符串，说明没写对。
-
repo.packagist是固定键名，不能是repos.packagist（多一个 s）、packagist.org或repositories.packagist -
composer是必须显式写出的type值，不是注释，也不能省略或替换成https - URL 必须以
https://开头，且末尾带/，比如https://mirrors.aliyun.com/composer/✅；https://mirrors.aliyun.com/composer❌（会拼成/composerpackages.json导致 404） - Windows 用户执行后需重启终端（PowerShell/CMD），否则读不到新配置
项目级配置才是独立开发者的“真·省心方案”
你本地用 composer config -g 配好了，但一到宝塔、Docker 或 GitHub Codespaces 里就失效——因为这些环境默认用 www、runner 或容器内非登录用户运行命令，压根读不到你的 ~/.composer/config.json。项目级配置直接写进 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.json），执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：不加-g） - 该命令会自动在
composer.json的repositories字段安全追加，key 固定为"packagist"，不会覆盖已有私有源 - 前提是
composer.json中"repositories"是对象{}而非数组[]；如果是数组，命令会报错，需先手动改成空对象再重试 - 千万别手写
"packagist.org": false——这会彻底关掉基础包校验，连php或ext-json都装不上
换源后依然卡住？清缓存和旧文件是硬性步骤
镜像只加速元数据拉取和 ZIP 包下载，不参与依赖解析。如果你发现 composer install 还是卡在 Loading composer repositories，大概率是因为 Composer 正在读本地缓存或旧 composer.lock 里的原始地址。
- 必须先运行：
composer clear-cache - 必须删掉整个
vendor/目录和composer.lock文件 - 再执行：
composer install（不是update）——update会照着旧 lock 文件里的 dist URL 下载，镜像形同虚设 - 若仍卡在
Resolving dependencies，那和镜像完全无关，典型原因是composer.json里写了太宽的版本约束（如"php": "^7.4 || ^8.0"），导致解析器穷举组合
最容易被忽略的一点：镜像源本身不解决依赖冲突或解析慢的问题，它只管“下载快不快”。一旦你删了 vendor 和 lock 还卡在解析阶段，别折腾镜像了，先检查 require 和 require-dev 里的版本范围是否合理。
