如何在GitLab中强制Git标签仅使用字母数字及下划线格式？

一、原生Git服务器端钩子方案 #

如果你的仓库是自建Git服务器，可通过服务器端pre-receive钩子实现标签校验，所有推送的标签都会经过检查，不符合规则直接拒绝。

1. 进入Git仓库服务器端的hooks文件夹（无pre-receive文件则新建）
2. 创建pre-receive脚本，内容如下：

#!/bin/bash

# 定义标签允许的字符：仅字母、数字、下划线
VALID_TAG_PATTERN='^[a-zA-Z0-9_]+$'

# 遍历所有推送的引用
while read old_rev new_rev ref_name; do
    # 仅处理标签类型的引用
    if [[ "$ref_name" =~ ^refs/tags/ ]]; then
        # 提取标签名称（去掉refs/tags/前缀）
        tag_name="${ref_name#refs/tags/}"
        # 校验标签名是否符合规则
        if ! [[ "$tag_name" =~ $VALID_TAG_PATTERN ]]; then
            echo "ERROR: 标签 '$tag_name' 不符合命名规范，仅允许字母、数字和下划线。" >&2
            exit 1
        fi
    fi
done

# 所有校验通过，允许推送
exit 0

3. 给脚本添加执行权限：

chmod +x hooks/pre-receive

此后任何用户推送不符合规则的标签时，都会收到错误提示并被拒绝。

二、GitLab内置功能实现 #

GitLab提供现成的推送规则（Push Rules），无需编写脚本即可实现标签校验，步骤如下：

1. 进入你的GitLab项目页面，点击左侧菜单的「设置」→「仓库」
2. 滚动到「推送规则」区域，点击展开
3. 在「标签名称规则」输入框中填入正则表达式：^[a-zA-Z0-9_]+$
4. 点击「保存变更」

设置完成后，无论是Git命令行推送标签，还是GitLab网页端创建标签，只要名称不符合规则，都会被自动拦截并提示错误。

注意：该功能需要项目维护者或所有者权限才能设置；已存在的不符合规则的标签不会被自动删除，需手动清理。

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