结论：vs code 中配 composer 中文镜像需在集成终端执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，90% 失败源于漏写 composer type 值或 url 缺末尾 /；配置错误时 composer 2.x 静默回退官方源且不报错，必须验证 composer config -g repo.packagist 输出完整 json 并执行 composer clear-cache 才生效。

直接说结论：VS Code 里配 Composer 中文镜像，不是装插件，也不是改 VS Code 设置，而是通过终端执行 composer config 命令写入配置文件；90% 的失败，是因为命令漏了 composer 这个 type 值，或 URL 少了末尾 /。

为什么 composer config -g repo.packagist 没反应？

它不是“没运行”，是 Composer 2.x 遇到错误配置会静默 fallback 到 https://packagist.org，不报错也不提示。常见失效原因：

• repo.packagist 写成 repos.packagist（多一个 s），配置被完全忽略
• 命令中漏掉中间那个 composer —— 它是 type 值，不是注释，不能省：❌ composer config -g repo.packagist https://mirrors.aliyun.com/composer/，✅ 正确是 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• URL 用 HTTP 或末尾没加 /，比如 https://mirrors.aliyun.com/composer → 请求会拼成 /composerpackages.json，返回 404
• Windows 用户改完没重启 VS Code 集成终端，旧终端进程仍读不到新写的 %APPDATA%\Composer\config.json

在 VS Code 集成终端里正确执行的步骤

必须关掉所有已打开的集成终端标签页，再新开一个（Ctrl+Shift+`），然后依次运行：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 https://mirrors.aliyun.com/composer/（推荐阿里云；也可换清华源：https://mirrors.tuna.tsinghua.edu.cn/composer/）
• composer config -g repo.packagist —— 必须看到完整 JSON 输出，如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，否则说明没写进去
• composer clear-cache —— 否则旧缓存里的官方源地址仍会被复用
• 如果之前跑过 composer install，还需删掉 vendor/ 和 composer.lock，再重装，否则 lock 文件里记录的仍是 packagist.org 的 dist URL

为什么项目级配置比全局更可靠？

全局配置写在 ~/.composer/config.json（Linux/macOS）或 %APPDATA%\Composer\config.json（Windows），但在实际开发中经常失效：

• CI/CD 流水线（如 GitHub Actions）、宝塔面板、Docker 容器默认以 www 或 runner 用户运行命令，根本读不到你当前用户的全局配置
• 项目根目录下一旦存在 composer.json 里的 repositories 字段，就会彻底屏蔽全局设置，且不提示
• 推荐做法：进项目根目录，运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不带 -g），它会自动安全合并进 composer.json 的 repositories 对象里，Git 可追踪，行为可复现
• 若原 composer.json 中 repositories 是数组（[]），该命令会失败；需先手动改为 {} 再执行

换源后依然卡在 Loading composer repositories 怎么办？

这不是镜像没切对，而是请求压根没发到镜像站。优先排查：

• 运行 composer diagnose | grep "Repo packagist.org"，看输出是否已是镜像地址；如果不是，说明项目级 repositories 覆盖了全局，或 composer.json 里写了 "packagist.org": false 这类禁用语句
• 删掉 vendor/ 和 composer.lock 后，用 composer install -vvv 观察日志，确认下载 URL 是否含 mirrors.aliyun.com
• 别忽略 composer update --lock —— 它强制刷新 composer.lock 中所有包的 dist URL，否则即使镜像生效，安装时仍会尝试旧地址

最常被忽略的点：镜像只影响元数据和 ZIP 包下载路径，不解决依赖解析慢、PHP 扩展缺失、或 composer.json 写法不合理的问题。如果 composer update 卡在 Resolving dependencies，那和镜像源完全无关。