在 composer 中配置多个 repositories 时，优先级由 composer.json 中的声明顺序决定，越靠前优先级越高。Composer 会依次查找仓库，一旦找到匹配包即停止搜索，因此私有仓库应置于默认 Packagist 前以实现覆盖。可通过 “packagist.org”: false 禁用默认仓库，仅使用私有源。建议将内部镜像或 VCS 仓库排前，保留公共仓库在后，避免同名同版本包冲突，确保依赖解析清晰可控。

在 Composer 中配置多个 repositories 并设置优先级，主要是通过在 composer.json 文件中按顺序声明仓库来实现的。Composer 会按照你在文件中定义的顺序依次查找包，先定义的仓库具有更高的优先级。

1. 配置多个 repositories

你可以在 composer.json 的 repositories 字段中添加多个自定义仓库，支持的类型包括 composer（私有镜像）、vcs（版本控制系统）、package 等。

示例：

{     "repositories": [         {             "type": "composer",             "url": "https://asset-packagist.org"         },         {             "type": "vcs",             "url": "https://github.com/your-company/your-private-repo.git"         },         {             "type": "package",             "package": {                 "name": "vendor/custom-package",                 "version": "1.0.0",                 "dist": {                     "url": "https://example.com/custom-package-1.0.0.zip",                     "type": "zip"                 }             }         }     ],     "require": {         "vendor/custom-package": "^1.0"     } } 

2. 仓库优先级规则

Composer 查找依赖时，会从上到下遍历 repositories 列表。一旦在某个仓库中找到匹配的包版本，就不会继续查找后面的仓库。

这意味着：

冬瓜配音

AI在线配音生成器

66

查看详情

• 排在前面的仓库优先级更高
• 如果你希望私有包覆盖 Packagist 上的同名包，应将私有仓库放在默认仓库之前
• 内置的 Packagist 是默认仓库，除非显式禁用，否则始终存在

3. 禁用默认 Packagist 仓库（可选）

如果你只想使用私有仓库，可以显式禁用默认的 Packagist：

{     "repositories": [         {             "packagist.org": false         },         {             "type": "composer",             "url": "https://your-private-composer-mirror.com"         }     ] } 

这样 Composer 就不会去 packagist.org 查找包，仅使用你指定的仓库。

4. 实际应用建议

常见场景是企业内使用私有 VCS 或私有 Composer 镜像，同时保留对公共包的访问：

• 把内部镜像或 VCS 放在前面，确保私有包优先被加载
• 保持 packagist.org 在后面，用于下载通用开源组件
• 避免在多个仓库中发布相同名称和版本的包，防止混淆

基本上就这些。只要注意仓库的书写顺序，就能有效控制依赖来源的优先级。