如何检查有效的Git分支名称？

章昱

2023-03-14

问题内容：

我正在git post- receive用Python开发一个钩子。数据stdin通过类似于以下内容的行提供

ef4d4037f8568e386629457d4d960915a85da2ae 61a4033ccf9159ae69f951f709d9c987d3c9f580 refs/heads/master

第一个哈希值是旧引用，第二个哈希值是新引用，第三列是要更新的引用。

我想将其分为3个变量，同时还要验证输入。 如何验证分支名称？

我目前正在使用以下正则表达式

^([0-9a-f]{40}) ([0-9a-f]{40}) refs/heads/([0-9a-zA-Z]+)$

如man git-check-ref-
format所示
，它不接受所有可能的分支名称。例如，它排除build-master有效的名称为的分支。

我实际上想排除以“ build-”开头的任何分支。可以在同一个正则表达式中完成吗？

给定以下出色的答案，我编写了一些测试，可以在https://github.com/alexchamberlain/githooks/blob/master/miscellaneous/git-
branch-re-
test.py
找到。

状态：以下所有正则表达式均无法编译。这可能表明我的脚本有问题或语法不兼容。

问题答案：

让我们剖析各种规则并从中构建正则表达式部分：

它们可以包括/用于层次结构（目录）分组的斜杠，但斜杠分隔的组件不能以点开头.或以序列结尾.lock。
```
 # must not contain /.
```
(?!.*/.)
# must not end with .lock
(?<!.lock)$
它们必须至少包含一个/。这会强制出现诸如heads /，tags /等类别，但是实际名称不受限制。如果使用该--allow-onelevel选项，则该规则将被放弃。
```
 .+/.+  # may get more precise later
```
它们..在任何地方都不能有两个连续的点。
```
 (?!.*\.\.)
```
它们不能在任何地方具有ASCII控制字符（即值小于\040或的字节\177 DEL），空格，代字号~，插入符^或冒号:。
```
 [^\000-\037\177 ~^:]+   # pattern for allowed characters
```
他们在任何地方都不能有问号?，星号*或方括号[。请参阅以下--refspec-pattern选项，了解此规则的例外情况。
```
 [^\000-\037\177 ~^:?*[]+   # new pattern for allowed characters
```
它们不能以斜杠开头或结尾，也不能/包含多个连续的斜杠（有关--normalize此规则的例外，请参阅下面的选项）
```
 ^(?!/)
```
(?<!/)$
(?!.*//)
它们不能以点结尾.。
```
 (?<!\.)$
```
它们不能包含序列@{。
```
 (?!.*@\{)
```
它们不能包含\。
```
 (?!.*\\)
```

将所有这些拼凑在一起，我们得出以下怪异现象：

^(?!.*/\.)(?!.*\.\.)(?!/)(?!.*//)(?!.*@\{)(?!.*\\)[^\000-\037\177 ~^:?*[]+/[^\000-\037\177 ~^:?*[]+(?<!\.lock)(?<!/)(?<!\.)$

而且，如果您要排除以这些开头的内容，build-则只需添加另一个前行即可：

^(?!build-)(?!.*/\.)(?!.*\.\.)(?!/)(?!.*//)(?!.*@\{)(?!.*\\)[^\000-\037\177 ~^:?*[]+/[^\000-\037\177 ~^:?*[]+(?<!\.lock)(?<!/)(?<!\.)$

可以通过合并一些寻找通用模式的东西来对此进行优化：

^(?!@$|build-|/|.*([/.]\.|//|@\{|\\))[^\000-\037\177 ~^:?*[]+/[^\000-\037\177 ~^:?*[]+(?<!\.lock|[/.])$