Composer拉取太慢想换源？全局替换与局部项目源的优先级【指南】-composer-PHP中文网

全局换源没生效是因为项目composer.json中存在repositories字段，会完全覆盖全局配置；验证需运行composer config --list（不带-g）查看实际生效的源。

composer拉取太慢想换源？全局替换与局部项目源的优先级【指南】

全局换源命令为什么没生效

执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 后，composer install 仍卡在 packagist.org，大概率是项目 composer.json 里显式写了 repositories 数组——它会**完全替换**全局设置，不是追加或 fallback。

常见错误现象：

composer config -g -l 显示镜像已切到阿里云，但项目中 composer install 还是走官方源
CI 流水线里依赖下载超时，本地却正常 → 项目级 repositories 覆盖了全局配置

验证方式：运行 composer config --list（不带 -g），看输出里 repositories 的实际内容。只要项目 composer.json 有 "repositories" 字段，全局的 repo.packagist 就彻底失效。

项目里写 repositories 怎么保证私仓优先

私有包（比如内部 SDK）必须出现在 repositories 数组最前面，否则会被 packagist 镜像“截胡”。Composer 查包时是严格按数组顺序逐个请求，**第一个返回有效元数据的源就立刻锁定，后续源完全不查**。

正确写法示例（放在 composer.json 的 repositories 顶部）：

"repositories": [
  {
    "type": "composer",
    "url": "https://pkg.internal/"
  },
  {
    "type": "composer",
    "url": "https://mirrors.aliyun.com/composer/"
  }
]

关键点：

Discussion Composer

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

下载

禁用官方源必须显式写 {"packagist.org": false}，只靠把镜像放第一行不够
别用 type: "package" 兜底全部包，它不支持版本发现，极易回退到 packagist
如果项目不需要私仓，就别写 repositories 字段——让全局镜像自然生效

想临时绕过项目配置用全局源怎么办

某些 CI 场景需要强制走全局镜像（比如统一 cache-dir 或跳过私仓认证），又不能改项目 composer.json。这时候不能删字段或硬改 JSON，得用环境变量控制加载路径。

推荐做法：

建一个最小化配置文件 ci-composer.json，内容只保留：{"config": {"repositories": [{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}]}}
执行：COMPOSER=ci-composer.json composer install
避免用 COMPOSER=/dev/null：它会跳过 autoload、scripts 等整个项目逻辑，仅适合调试 config 本身

注意：composer config --global 修改后，已有项目不会自动更新，必须重新运行 composer install 或 update 才会应用新源。

bin-dir 和 vendor-dir 路径冲突导致脚本不生成

项目里配了 "bin-dir": "bin"，但 vendor/bin 下始终没生成可执行脚本？很可能是 bin-dir 路径校验失败——Composer 要求 bin-dir 必须是绝对路径，或位于 vendor-dir 目录内，否则会静默回退到默认的 vendor/bin。

典型问题：

"vendor-dir": "lib/vendor" + "bin-dir": "bin" → bin 不在 lib/vendor 下，被忽略
"bin-dir": "/usr/local/bin" 是绝对路径，但和 vendor-dir 无关，也会被静默丢弃
想用项目级 bin 目录，就得写成 "bin-dir": "lib/vendor/bin" 或直接用绝对路径（如 /var/www/project/bin）

验证方法：运行 composer config bin-dir，看输出是否和你预期一致；再检查 vendor/bin 是否存在且有执行权限。