可在 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 的严格匹配。

# js  # git  # json  # composer  # github  # ai  # 常见问题  # require  # Token  # private  # internal  # svn  # ssh  # 自定义  # 自己的  # 第一个  # 尤其是  # 多个  # 适用于  # 这类  # 可在  # 报错  # 首个