Which characters are illegal within a branch name?
Creating a New Branch In Git, the git branch branch-name command is used to create a new branch called branch-name . Branches should be named something that describes the purpose of the branch. Note that branch names can't contain whitespace: new-feature and new_feature are valid branch names, but new feature is not.
Branch NamingUse only lower case alphanumeric characters. Use '-' rather than spaces or underscores.
Naming rules for refname:
Git imposes the following rules on how references are named:
They can include slash
/for hierarchical (directory) grouping, but no slash-separated component can begin with a dot.or end with the sequence.lock.They must contain at least one
/. This enforces the presence of a category likeheads/,tags/etc. but the actual names are not restricted. If the--allow-oneleveloption is used, this rule is waived.They cannot have two consecutive dots
..anywhere.They cannot have ASCII control characters (i.e. bytes whose values are lower than
\040, or\177DEL), space, tilde~, caret^, or colon:anywhere.They cannot have question-mark
?, asterisk*, or open bracket[anywhere. See the--refspec-patternoption below for an exception to this rule.They cannot begin or end with a slash
/or contain multiple consecutive slashes (see the--normalizeoption below for an exception to this rule)They cannot end with a dot
.They cannot contain a sequence
@{.They cannot be the single character
@.They cannot contain a
\.
On top of that, additional rule for branch name:
- They cannot start with a dash
-
Thanks to Jakub Narębski, the man page for git check-ref-format has more details.
If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!
Donate Us With