可在 composer.json 中通过 repositories 字段为特定包指定安装源，无需全局替换 Packagist；需确保自定义源中包名、版本与声明完全一致，并优先使用列表首个匹配源。
可以在 composer.json 中通过 repositories 字段为特定包指定安装源，无需全局替换 Packagist。关键在于：用自定义 repository 覆盖默认源，并确保包名、版本与源中一致。
添加自定义 repository（支持多种类型）
在 composer.json 根节点下添加 repositories 数组，每个条目描述一个源。常用类型有：
-
vcs：指向 Git/SVN/Hg 仓库（自动解析
composer.json） - package：手动声明单个包的元信息（适合私有或无 composer.json 的项目）
- composer：指向另一个 Composer 仓库（如私有 Satis 或 Private Packagist）
用 vcs 源覆盖某个包（推荐用于开发中）
例如想从自己的 GitHub 分支安装 monolog/monolog：
"repositories": [
{
"type": "vcs",
"url": "https://github.com/yourname/monolog"
}
]
Composer 会优先从此仓库拉取 monolog/monolog，前提是该仓库根目录有有效的 composer.json，且其中 "name" 字段必须严格匹配 "monolog/monolog"。分支或 tag 会自动映射为版本号（如 dev-feature/log-context 对应 dev-feature-log-context）。
用 package 源精确控制私有包
适用于没有公开仓库、或需锁定某次提交的场景：
"repositories": [
{
"type": "package",
"package": {
"name": "acme/internal-tool",
"version": "1.2.3",
"dist": {
"url": "https://example.com/internal-tool-1.2.3.zip",
"type": "zip"
},
"autoload": {
"psr-4": { "Acme\\Internal\\": "src/" }
}
}
}
]
之后运行 composer require acme/internal-tool:1.2.3 即可安装。注意：version 必须明确，不能写 dev-main 这类别名。
注意事项和常见问题
自定义 repository 仅对当前项目生效；若多个 repository 提供同名同版本包，Composer 使用列表中**第一个匹配的**；启用后建议运行 composer clear-cache 避免旧缓存干扰；私有 Git 仓库需配置 SSH 密钥或 token 认证，否则会报错“Could not fetch”。
基本上就这些。不复杂但容易忽略细节，尤其是 name 和 version 的严格匹配。
