composer config -g repo.packagist 必须加 -g 才写入全局配置文件（如 ~/.composer/config.json），实现一次设置、处处生效；不加则仅影响当前项目，切换目录或终端即失效。
composer config -g repo.packagist 命令为什么必须带 -g
不加 -g 就是项目级配置，只影响当前目录下的 composer.json，换终端、切项目就失效。全局配置写在 ~/.composer/config.json（Windows 是 C:\Users\用户名\AppData\Roaming\Composer\config.json），所有命令默认读它——这才是“一次设置，处处生效”的关键。
常见错误现象：
- 执行了
composer config repo.packagist composer https://mirrors.aliyun.com/composer/却没生效，八成是漏了-g - 用
sudo composer config -g ...导致配置写进 root 用户路径，当前用户运行时根本读不到 - 输出
Command "config" is not defined：Composer 版本低于 2.0，先跑composer self-update
阿里云镜像 URL 末尾斜杠不能省，否则 404
https://mirrors.aliyun.com/composer/ 和 https://mirrors.aliyun.com/composer 是两个不同地址。后者会返回 HTTP 404，因为镜像站后端路由依赖末尾斜杠识别为 Composer 类型仓库。腾讯云镜像同理：https://mirrors.cloud.tencent.com/composer/。
验证方式很简单：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 浏览器直接打开该 URL，应看到 JSON 格式的
{"packages":{}}或类似索引结构 - 执行
composer config -g repo.packagist，输出里 URL 必须带末尾斜杠 - 若输出是空、
null或https://packagist.org，说明配置失败或被覆盖
为什么 composer diagnose 显示 Repo packagist.org is default
这代表镜像根本没接管请求，90% 是项目级配置劫持了全局设置。Composer 加载仓库的优先级是：项目 composer.json 的 repositories 字段 → 当前用户配置（~/.composer/config.json）→ 全局 fallback。只要项目里写了 "packagist.org" 或完整 "repositories" 对象，全局镜像就会被无视。
排查步骤：
- 运行
composer config -l | grep repositories，看输出是否含项目路径 - 检查项目
composer.json是否有"repositories"字段；若有，且里面包含"type": "composer", "url": "https://packagist.org"，就手动删掉或改成镜像地址 - 临时绕过项目配置：加
--repository参数重试，比如composer install -vvv --repository=https://mirrors.aliyun.com/composer/，-vvv能打印真实请求 URL，一眼确认走没走镜像
有些包还是从 packagist.org 下载？不是镜像问题
镜像只代理 Packagist 官方源的元数据和 dist 包。以下情况必然绕过镜像：
- 包本身声明了私有
repositories（如公司内网 Satis 源、GitLab 私仓） - 依赖用了
path类型仓库（例如"../my-local-package"） - 包被标记为
abandoned，Composer 会回源拉取原始composer.json做兼容处理 - 新发布的包尚未同步到镜像（通常延迟 5–30 分钟）
这时候别急着换镜像，先用 composer show vendor/package -vvv 看实际请求地址，再决定是等同步、改源，还是联系包维护者。
