Composer无法识别fork包指定分支版本，安装更新遇错求助

核心原因 #

Composer默认优先从Packagist拉取包信息，而目标fork的minimal分支未同步到Packagist，导致Composer无法匹配dev-minimal约束；另外，缓存的旧包信息也可能干扰版本识别。

解决方案步骤 #

1. 修复Composer仓库配置（强制指定分支别名）

修改composer.json，给目标fork仓库添加分支别名配置，确保Composer能识别dev-minimal对应到仓库的minimal分支：

{
    "name": "shorton/temp",
    "type": "project",
    "authors": [
        {
            "name": "short one",
            "email": "root@host.local"
        }
    ],
    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/doersf/bitcoin-php.git",
            "aliases": [
                {
                    "alias": "dev-minimal",
                    "branch": "minimal"
                }
            ]
        },
        // 可选：禁用Packagist，避免优先拉取官方包
        {
            "packagist": false
        }
    ],
    "require":{
        "bitwasp/bitcoin": "dev-minimal"
    }
}

2. 清理Composer缓存

执行命令清除缓存，确保Composer重新拉取最新的仓库分支信息：

composer clear-cache

3. 重新执行安装/更新

• 测试项目直接执行：

composer update

• 现有项目（需更新锁定版本）：
  1. 先备份composer.lock和vendor目录（避免丢失依赖）
  2. 删除composer.lock和vendor
  3. 执行composer install重新生成依赖锁文件；或单独更新目标包：

  composer update bitwasp/bitcoin
  

额外检查点 #

确认fork仓库的minimal分支下，composer.json的name字段确实为bitwasp/bitcoin，且无其他版本约束冲突。

内容的提问来源于stack exchange，提问作者Steven Horton