Composer无法识别带斜杠的Git标签，如何配置拉取对应版本？

你碰到的这个问题确实是因为Composer默认严格遵循语义化版本（SemVer）规范，version/2.3.1这种带斜杠的标签格式不符合它对版本号的解析规则，所以会抛出版本解析错误。不过有两种简单的方法可以让Composer正确识别这类标签：

方法一：使用版本别名映射 #

直接在require-dev里给非标准标签设置一个符合SemVer的别名，让Composer把它当作标准版本处理：

修改你的composer.json配置如下：

{
  "repositories": [
    {
      "type": "vcs",
      "url": "git@github.com:woocommerce/storefront.git"
    }
  ],
  "require-dev": {
    "woocommerce/storefront": "dev-version/2.3.1 as 2.3.1"
  }
}

这里的dev-version/2.3.1是Composer对带斜杠标签的识别方式（它会把这类标签视为开发分支/引用），通过as 2.3.1给它赋予一个标准版本别名，就能绕过版本解析错误。

方法二：在仓库配置中手动映射版本 #

如果需要同时处理多个这类非标准标签，或者希望require部分保持简洁，可以在仓库的配置里添加versions字段，手动建立标准版本号和Git标签的映射：

{
  "repositories": [
    {
      "type": "vcs",
      "url": "git@github.com:woocommerce/storefront.git",
      "versions": {
        "woocommerce/storefront": {
          "2.3.1": "version/2.3.1"
        }
      }
    }
  ],
  "require-dev": {
    "woocommerce/storefront": "2.3.1"
  }
}

这种方式下，当Composer查找2.3.1版本时，会自动对应到仓库里的version/2.3.1标签，配置逻辑更清晰。

额外小提示 #

如果你不确定仓库里的标签是否存在，可以执行下面的命令列出所有远程标签：

git ls-remote --tags git@github.com:woocommerce/storefront.git

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