composer config -g repo.packagist 命令必须同时满足三个硬性条件才生效：①键名严格为 repo.packagist（单数、小写、不可加 s 或后缀）；②第二个参数必须显式指定为 composer（type 值，不可省略或替换）；③url 必须是 https 且以 / 结尾（如 https://mirrors.aliyun.com/composer/），否则静默回退官方源。
composer config -g repo.packagist 命令的三个硬性参数
这条命令不是“填个 URL 就完事”，它有三个不可妥协的参数条件，缺一即静默失效——不报错、不提示、照常连官方源。
-
repo.packagist是唯一合法键名：写成repos.packagist（多 s）、packagist.org或repositories都无效；Composer 2.x+ 完全忽略 -
composer是必须显式的type值：不能省略，也不能写成"type": "composer"以外的字符串（比如"composer-source"） - URL 必须是 HTTPS 且以
/结尾：例如https://mirrors.aliyun.com/composer/✅，而https://mirrors.aliyun.com/composer❌（少斜杠会导致请求路径拼成/composerpackages.json，返回 404）
验证是否写对，只看这一行：composer config -g repo.packagist。输出必须是完整 JSON 对象，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。返回空、null、Key not found 或纯字符串 URL，说明没生效。
项目级配置中 repositories 字段的结构陷阱
项目级配置写进 composer.json，但结构稍有偏差就会被 Composer 忽略或覆盖私有源。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
repositories必须是数组，不是对象：错误写法"repositories": {"packagist": {...}}会被完全跳过；正确写法是"repositories": [{"type": "composer", "url": "..."}] -
镜像源必须放在
repositories数组首位：Composer 按顺序尝试，第一个能响应的源就用它，后面全跳过 - 别手动加
"packagist.org": false：这个字段必须放在repositories外层根节点，且值应为true（默认），设为false会直接屏蔽基础包发现逻辑 - 已有私有 VCS 源时，
composer config repo.packagist ...（不加-g）会**全量替换**整个repositories字段，不是追加——建议手动编辑composer.json，把镜像对象插入数组开头
全局 vs 项目级配置的优先级与生效边界
Composer 的仓库加载顺序是硬编码的：项目级 composer.json > 全局 ~/.composer/config.json > 默认源。这意味着：
- 只要项目里定义了
"repositories": [...]（哪怕内容为空），全局配置就彻底失效 - CI 环境（如 GitHub Actions、GitLab Runner）通常以
runner或www用户运行，读不到你本地~/.composer/config.json，所以全局配置在 CI 中基本不可靠 - Windows 用户执行
composer config -g后需重启 PowerShell/CMD 才能读到新配置；Docker 或宝塔环境若禁用了proc_open，该命令会直接报错 - 临时绕过所有配置，单次生效用
--repository-url：例如composer update --repository-url=https://mirrors.aliyun.com/composer/，但注意create-project不支持该参数
换源后仍卡住？缓存和锁文件才是关键
镜像只加速元数据拉取和 ZIP 包下载，不参与依赖解析。如果你看到 Loading composer repositories 卡住，大概率是缓存或锁文件还在引用旧地址。
- 必须执行
composer clear-cache：否则 Composer 会从本地缓存读取过期的packages.json - 必须删除
vendor/和composer.lock：composer update会沿用 lock 文件里的 dist URL，只有composer install（配合全新 lock）才真正走新镜像 - 如果
composer install -vvv日志里仍出现packagist.org，说明镜像根本没生效，或被项目级repositories错误覆盖 -
Resolving dependencies卡顿和镜像无关：那是版本约束太宽泛（如"^1.0 || ^2.0"）导致解析器穷举，需优化composer.json中的require版本号
最易被忽略的一点：镜像配置本身不会自动刷新已存在的 composer.lock，哪怕你改了 10 遍配置，只要 lock 文件还在，Composer 就按它执行——删 lock 文件不是“重来”，而是“重新协商”。
