git tag:标签名格式无效
快速摘要
你尝试创建的标签名包含空格、冒号或其他禁止字符 —— git 将其拒绝为无效引用名。
为什么发生
标签名包含空格、波浪号、脱字符或冒号,这些在 git 引用名中不允许
标签名以点、连字符或斜杠开头,使其成为无效的引用命名空间前缀
标签名包含双点(..)或以 .lock 结尾,这些 git 保留作内部使用
最小示例
✗ 错误代码
git tag 'v1.0: beta' # error: invalid tag name: 'v1.0: beta'✓ 修复代码
git tag 'v1.0-beta' # valid tag name with hyphen instead of colon-space冒号和空格在 git 引用名中被禁止 —— 用连字符替换可产生 git 接受的有效标签名。
如何诊断
检查标签名中的禁止字符:空格、~、^、:、?、*、[、\ 和控制字符
运行 git tag 列出现有标签,与你的目标标签名比较命名约定
使用 git check-ref-format <tag-name> 在创建标签前验证名称
如何修复
将禁止字符替换为连字符或下划线,如 'v1.0-rc' 而非 'v1.0 rc'
移除前导点或连字符,确保名称不含双点且不以 .lock 结尾
使用 git check-ref-format --branch <name> 在创建前验证并规范化标签名
如何预防
在脚本或自动化中创建标签前,始终用 git check-ref-format 验证标签名
遵循一致的标签约定如 vMAJOR.MINOR.PATCH,避免所有禁止字符