git tagでかっこ付きのタグを作成する

git tagでかっこ()付きのタグを作成する機会があり、その際に少し詰まったので共有します。

環境

• MacOS 14.5
• git version 2.46.0

事象

git tagで以下のように()付きのタグを作成しようとしたところ、下記のエラーが発生しました。

git tag v1.0.0(hogehoge)
bash: syntax error near unexpected token `('

解消方法

タグ名をダブルクオーテーションで囲むだけです。
これで()付きのタグを作成できます。

git tag "v1.0.0(hogehoge)"

なぜエラーになったのか？

()が特殊な文字として扱われたからです。

bashには()でくくったコマンドをサブシェルで実行するという機能があり、そのため()が特殊な文字として扱われてしまうようです。

()をタグ名として使うためには、bashに()を普通の文字として扱ってもらう必要があります。
""や\でエスケープすると、普通の文字として扱われます。

参考