Git 推送时报 src refspec matches more than one：分支与标签同名

本地同时有名为 release-1.0 的分支和标签，执行下面的推送时，Git 无法确定要发送哪一个：

git push origin release-1.0

报错类似：

error: src refspec release-1.0 matches more than one
error: failed to push some refs to 'REMOTE_URL'

短名称同时匹配了本地分支和标签。分支完整名称是 refs/heads/release-1.0，标签则是 refs/tags/release-1.0。两者可以共存，但只写短名称推送就可能产生歧义。

这与 does not match any 不同：后者通常要检查来源是否存在，这里则要明确选中哪个已经存在的引用。增加强制推送参数不能替你做这个选择，也没有必要先删除标签。

以下以 Git 命令行为例；图形客户端如果生成同样的短名称命令，也会遇到这个问题。origin 和 release-1.0 都是示例，需要替换成实际远程名称和引用名称。

分别核对本地分支和标签

在要推送的仓库目录中执行：

git show-ref --verify refs/heads/release-1.0
git show-ref --verify refs/tags/release-1.0

--verify 要求精确的引用路径，能区分两个名称空间。若两条都输出对象 ID 和对应完整名称，就确认了本地确实有同名分支与标签。

两条记录即使显示相同的对象 ID，仍是两个不同的引用；Git 不会因为它们暂时指向同一对象，就替你决定推送分支还是标签。附注标签的引用还可能指向标签对象，因此也不能只比较显示的 ID 来判断它是否与分支关联同一提交。

如果其中一条不存在，不要为了凑齐示例而新建它。核对报错中的实际名称、客户端生成的完整命令，以及当前仓库是否正确；本文的同名分支和标签条件尚未得到确认。

只推标签，明确使用标签名称空间

如果目的就是发布标签，先预览这一次引用更新：

git push --dry-run origin refs/tags/release-1.0:refs/tags/release-1.0

冒号左边是本地来源，右边是远程目标。两端都写完整名称后，本地同名分支不会再被当作候选来源，远程目标也明确是标签。

确认远程仓库、标签和准备发布的内容正确后，再执行实际推送：

git push origin refs/tags/release-1.0:refs/tags/release-1.0

Git 还提供下面的等价简写，二者选一种即可，不需要连续执行：

git push origin tag release-1.0

这里的 tag 是推送单个指定标签的特殊语法，不是 --tags。后者会扩大到推送所有本地标签，不适合仅为消除一个名称歧义而使用。

--dry-run 不实际发送引用更新，适合预览目标；它不保证稍后的真实推送一定获准。远程状态、权限和服务端接收规则仍可能让实际操作失败。

要推分支，就把两端写成 refs/heads

如果目的是更新分支，使用分支的完整名称：

git push --dry-run origin refs/heads/release-1.0:refs/heads/release-1.0
git push origin refs/heads/release-1.0:refs/heads/release-1.0

第二条只应在预览和内容检查通过后执行。这条映射不会把同名标签改成分支，也不要求先切换到该分支：来源已经由完整引用指定，务必确认其中的提交就是准备发布的内容。

若错误变成 non-fast-forward、标签已存在或保护规则拒绝，名称歧义已经消除，新的拒绝原因需要另行处理。不要因此追加 --force。尤其是远程已有的发布标签，覆盖它可能改变其他人使用同一版本名得到的内容，应先核对远程对象和团队发布规则。

报错写的是 dst refspec ... matches more than one 时，歧义位于远程目标。仍应先确认要更新的是远程分支还是标签，再显式写出右侧名称空间；不要只根据相似报错盲目选择标签路线。

核对远程结果并保留同名的另一条引用

标签推送完成后，用下面两条命令比较本地与远程标签引用：

git show-ref --verify refs/tags/release-1.0
git ls-remote --refs origin refs/tags/release-1.0

若查询的是刚才接收推送的同一个仓库，且期间没有其他更新，两边标签引用的对象 ID 应一致。--refs 不输出附注标签解引用后的 ^{} 行，避免把标签对象 ID 和它最终指向的提交 ID 混着比较。分支路线则把两条命令中的 refs/tags/ 都换成 refs/heads/。

远程查询没有匹配行或连接失败，都不能算验证通过。若远程配置区分读取地址和推送地址，应查询实际接收推送的一端，不能用尚未同步的镜像判断结果。

写明完整引用后，不改本地分支或标签，因此没有本地改名、删标签之类的恢复步骤。已经成功发布的远程引用则可能触发构建或发布流程；如果推错了，应先记录更新前后的对象 ID 并确认协作影响，再按项目流程回退，不要立即删除同名的分支和标签。