应使用 composer config -g repos.packagist '{"type": "composer", "url": "https://packagist.gitee.com"}' 启用 Gitee 镜像，因其仅支持插件式配置且不兼容直接替换默认源，同时只代理 stable 包。
Composer 默认走 Packagist 官方源（https://packagist.org），在国内直连经常超时或卡死，换码云（Gitee）镜像源是有效提速手段，但要注意：它只是镜像，不是所有包都实时同步，且自建包无法被收录。
为什么不能直接用 composer config -g repo.packagist 改成码云地址
因为码云镜像源（如 https://packagist.phpcomposer.com）已停用多年；当前可用的是 Gitee 官方维护的 https://packagist.gitee.com，但它不支持完整 Packagist 协议 —— 比如不响应 /packages/list.json，直接配置会触发 Could not fetch packages.json 错误。
- 真正能用的方案是通过
composer config -g repos.packagist启用「repo 插件式镜像」，而非覆盖默认源 - 必须指定
type: composer和有效url，否则 Composer 会忽略该 repo - Gitee 镜像仅代理稳定版（
stable）包，dev-master等开发分支大概率 404
正确配置 Gitee Composer 镜像的三步操作
执行以下命令即可全局启用（注意顺序和引号）：
composer config -g repos.packagist '{"type": "composer", "url": "https://packagist.gitee.com"}'
验证是否生效：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer config -g repos.packagist
输出应为完整 JSON 对象，不是 null 或空值。若报错 Could not write to /path/to/composer.json，说明权限不足，改用 sudo 或切到用户目录再试。
- 该配置写入的是全局
composer.json（通常在~/.composer/config.json），不影响项目级设置 - 如果项目中已有
repositories字段，Gitee 镜像不会自动降级为 fallback，需手动加"packagist": false关闭默认源 - 某些旧版 Composer（repos.packagist 别名，建议升级到
2.x再配置
遇到 Package not found 时优先检查什么
不是所有包都能从 Gitee 镜像拉到，尤其小众、私有或刚发布不到 24 小时的包。
- 先用
composer show vendor/package测试官方源是否可达（临时关镜像：composer config -g repos.packagist --unset） - 访问
https://packagist.gitee.com/p/packages/vendor/package.json看返回是否为 200 + 有效 JSON - 若返回 404，说明该包未被镜像收录，此时只能回退到官方源，或换阿里云镜像（
https://mirrors.aliyun.com/composer/）尝试 - 注意：Gitee 镜像不支持
search命令，composer search xxx仍走官方 API
真正关键的不是换哪个镜像，而是理解镜像的同步延迟和覆盖范围 —— 它解决的是「下载慢」，不是「找不到包」。一旦遇到 404，别硬等同步，立刻切源或查 Packagist 原始页面确认是否存在。
