Composer配置VCS仓库后无法拉取自定义fork版本问题

排查与解决步骤 #

• 调整仓库优先级
  确保你的fork仓库配置写在原仓库（比如packagist）之前，Composer会按配置顺序查找仓库，原仓库在前会优先匹配旧版本。示例配置：

  "repositories": [
      {
          "type": "vcs",
          "url": "https://github.com/你的用户名/yii2-select-google-map-location.git"
      },
      {
          "type": "composer",
          "url": "https://packagist.org"
      }
  ]
  

• 强制指定版本安装
  直接指定fork仓库的1.1.6版本安装，若无效则加--prefer-source参数强制从你的VCS拉取：

  composer require kalyabin/yii2-select-google-map-location:1.1.6
  # 若上面命令无效，执行：
  composer require kalyabin/yii2-select-google-map-location:1.1.6 --prefer-source
  

• 清理Composer缓存
  Composer可能缓存了原仓库的版本信息，清理后再操作：

  composer clear-cache
  

• 检查版本约束冲突
  确认项目composer.json的require字段里，该包的版本约束是否限制了升级，比如写了^1.1.4会限制到1.1.x的兼容版本，可改成^1.1.6或>=1.1.6后再更新。

• 验证Fork仓库的版本标识
  确认你fork的仓库里存在1.1.6的标签，若标签未正确创建，可直接指定分支安装（假设分支名为1.1.6-fix）：

  composer require kalyabin/yii2-select-google-map-location:dev-1.1.6-fix
  

• 对比正常配置找差异
  将这个有问题的VCS配置和另一个正常工作的配置对比，检查仓库类型、URL拼写、私有仓库认证（若涉及）等是否存在差异。

问题定位验证 #

执行composer update kalyabin/yii2-select-google-map-location -vv，查看详细日志，确认Composer拉取版本时指向的仓库地址，以此定位具体问题点。

内容的提问来源于stack exchange，提问作者Martin Pineault