Composer中国镜像站使用说明及配置-composer-PHP中文网

最有效解法是更换国内镜像源：临时用--repository-url参数（单次生效）、全局用composer config -g repo.packagist composer url、项目级在composer.json中配置repositories并设"packagist.org": false，注意url末尾斜杠、type必须为composer、键名严格为repo.packagist。

composer中国镜像站使用说明及配置

Composer 默认从国外源下载包，国内直连经常超时或失败，直接换镜像源是最简单有效的解决办法。国内主流镜像（如阿里云、腾讯云、华为云）基本已支持 Composer 2.x 的完整协议，无需降级或额外插件。

如何临时切换镜像源（单次命令生效）

不改全局配置，只对当前命令生效，适合调试或 CI 场景：

用 composer create-project 时加 --repository-url 参数：
composer create-project laravel/laravel myapp --repository-url=https://mirrors.aliyun.com/composer/
安装依赖时指定源：
composer require monolog/monolog --repository-url=https://mirrors.tencent.com/composer/

注意：--repository-url 只影响本次操作的包发现与下载，不会写入 composer.json 或修改本地配置；若项目已有 repositories 字段，该参数会优先级更高。

永久配置全局镜像源（推荐日常开发）

执行一条命令即可覆盖用户级配置（路径为 ~/.composer/config.json），后续所有 composer install、update 都自动走镜像：

阿里云：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
腾讯云：
composer config -g repo.packagist composer https://mirrors.tencent.com/composer/
华为云：
composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/

执行后可运行 composer config -g repo.packagist 确认是否生效；若之前手动改过 config.json，建议先备份再执行，避免字段冲突。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

项目级配置（多团队协作或混合源需求）

当某个项目必须用官方源（比如验证安全审计结果），或需同时接入私有包仓库，应在项目根目录的 composer.json 中显式声明：

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://mirrors.aliyun.com/composer/"
        },
        {
            "type": "package",
            "package": {
                "name": "mycorp/internal-sdk",
                "version": "1.0.0",
                "dist": {
                    "url": "https://internal.example.com/sdk-1.0.0.zip",
                    "type": "zip"
                }
            }
        }
    ],
    "packagist.org": false
}

"packagist.org": false 是关键——它禁用默认源，强制只走 repositories 列表；漏掉这行，镜像源和官方源会并存，可能引发版本混乱或重复下载。

常见问题与避坑点

镜像不是万能加速器，有些情况仍会失败：

composer update 卡在 Resolving dependencies：不是网络问题，而是镜像同步有延迟（通常 10–30 分钟），可加 -vvv 看具体卡在哪条依赖，临时切回官方源重试：
composer config -g repo.packagist composer https://packagist.org
报错 Could not find package xxx at any version：检查镜像 URL 末尾是否多了斜杠（如 https://mirrors.aliyun.com/composer//），多余斜杠会导致 404；正确地址不含双斜杠
私有 Git 仓库（如 GitHub Enterprise）不受镜像影响：镜像只代理 Packagist 元数据和 ZIP 包，vcs 类型仓库仍走原始 Git 协议

镜像源本质是元数据缓存，不是所有包都能立刻同步；遇到冷门包或新发布版本，耐心等几分钟或查对应镜像站状态页更省时间。