Git获取两标签间提交历史报错：需用'--'分隔路径与版本号

问题复现 #

执行查询两标签间提交的命令时偶现报错，命令与报错输出如下：

git log '--pretty=format:%ad - %s [%an]' v1.0.11...b1.0.12
fatal: ambiguous argument 'v1.0.11...b1.0.12': unknown revision or path not in the working tree.
Use '--' to separate paths from revisions, like this:
'git <command> [<revision>...] -- [<file>...]'

该问题无稳定复现规律，同一条命令部分场景可正常执行，部分场景触发报错。

排查方向 #

• 本地标签完整性校验：触发报错时优先执行git tag | grep -E "v1.0.11|b1.0.12"，确认两个目标标签是否存在于本地标签列表。标签未同步到本地时，Git无法将传入字符串识别为有效修订版本，会转而尝试匹配工作区路径，是该偶现问题的最高频诱因。
• 同名路径冲突校验：执行find . -maxdepth 1 -name "*v1.0.11*" -o -name "*b1.0.12*"，检查工作区根目录是否存在与标签名完全一致的文件/文件夹。存在同名路径时，Git无法自动判定传入参数属于修订版本还是文件路径，会随机触发歧义报错。
• 语法合法性校验：检查命令中的区间连接符为半角三个连续.，无全角符号、多余空格，不要误写为两点..，语法格式错误会导致Git无法正确解析提交区间。

修复方案 #

• 同步全量远端标签：执行git fetch origin --tags拉取远端仓库所有最新标签到本地，解决本地标签缺失导致的参数识别失败问题，绝大多数偶现场景执行该操作后即可恢复正常。
• 显式添加分隔符消除歧义：直接在修订版本参数末尾添加--，明确告知Git前面的所有参数均为修订版本，后续无文件路径参数，从语法层面彻底避免歧义，修改后命令如下：

git log '--pretty=format:%ad - %s [%an]' v1.0.11...b1.0.12 --

• 强制指定参数类型绕过路径匹配：如果工作区确实存在与标签同名的文件/文件夹，可以在标签名前添加refs/tags/前缀，强制Git将传入参数识别为标签引用，而非路径，示例命令如下：

git log '--pretty=format:%ad - %s [%an]' refs/tags/v1.0.11...refs/tags/b1.0.12

• 校验标签名正确性：如果上述操作都无法解决，执行git ls-remote --tags origin核对远端标签列表，确认是否存在标签名书写错误（例如将v1.0.12误写为b1.0.12），修正拼写后重试即可。

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