git tagで、リリースのバージョンにタグを付ける方法

​​Git​コマンドライン

リリースしたバージョン(v1.2.0 など)がどのコミットだったかを、あとから名前で取り出せるようにするには、git tag -a でコミットにタグを付けます。タグは git push だけではリモートに送られないので、タグを付けたあとに送る操作も要ります。タグを付けてから、一覧を見て、リモートにプッシュし、消すまでの流れを、検証環境での実際の出力で確かめました。

補足

検証環境は Ubuntu 24.04、Git 2.43.0 です。作者の名前とメールアドレスには例示用の値(Neko <neko@example.com>)を設定しました。出力が毎回同じになるよう、コミットとタグの日時は環境変数 GIT_AUTHOR_DATE と GIT_COMMITTER_DATE で決めています。プッシュ先は、同じ環境に作ったベアリポジトリ(../remote.git)です。GitHub などのホスティングサービスへのプッシュ、GitHub の Releases の画面、GPG で署名したタグ(-s)は試していません。Windows と macOS での動作も確かめていません。

タグを付ける前のリポジトリ

app.txt のバージョンを 1.0.0、1.1.0、1.2.0 と上げてきたリポジトリです。main はプッシュ済みで、タグはまだ1つもありません。

console
$ git tag

$ git log --oneline --decorate
0edd44a (HEAD -> main, origin/main) 1.2.0 の準備
f173986 1.1.0 の準備
62e82a6 1.0.0 の準備
f18407a 最初のコミット

git tag を引数なしで実行すると、タグの一覧が出ます。ここでは何も出ません。

git tag -a で、いまのコミットにタグを付ける

いまのコミット(0edd44a)を 1.2.0 としてリリースする、という場面です。-a を付け、-m でメッセージを渡します。

console
$ git tag -a v1.2.0 -m "バージョン 1.2.0"

$ git tag
v1.2.0

$ git log --oneline --decorate
0edd44a (HEAD -> main, tag: v1.2.0, origin/main) 1.2.0 の準備
f173986 1.1.0 の準備
62e82a6 1.0.0 の準備
f18407a 最初のコミット

git log --decorate で、0edd44a に tag: v1.2.0 が付いたのが分かります。-m を付けないと、メッセージを書くエディターが開きます(git tag の公式リファレンス)。

git show にタグの名前を渡すと、タグの情報と、タグが指すコミットがまとめて出ます。

console
$ git show v1.2.0
tag v1.2.0
Tagger: Neko <neko@example.com>
Date:   Wed Nov 11 11:00:00 2026 +0900

バージョン 1.2.0

commit 0edd44aff4507c1cf1cd64edbe0358d702e42bfa
Author: Neko <neko@example.com>
Date:   Wed Nov 11 10:30:00 2026 +0900

    1.2.0 の準備

diff --git a/app.txt b/app.txt
index 92cf5fa..3f0a2ab 100644
--- a/app.txt
+++ b/app.txt
@@ -1 +1 @@
-version: 1.1.0
+version: 1.2.0

先頭の tag v1.2.0 からメッセージまでがタグの情報です。Tagger: にタグを付けた人、Date: にタグを付けた日時(11:00)、その下にメッセージが入っています。コミットの日時(10:30)とは別に記録されます。

注釈付きタグと軽量タグの違い

-a を付けて作ったタグを、注釈付きタグ(annotated tag)と呼びます。-a も -m も付けずに git tag 名前 とすると、軽量タグ(lightweight tag)になります。違いは、git cat-file -t でタグの名前が指すものの種類を見ると分かります。

console
$ git cat-file -t v1.2.0
tag

$ git cat-file -p v1.2.0
object 0edd44aff4507c1cf1cd64edbe0358d702e42bfa
type commit
tag v1.2.0
tagger Neko <neko@example.com> 1794362400 +0900

バージョン 1.2.0

注釈付きタグの名前は、tag という種類のオブジェクトを指しています。その中に、指す先のコミット(object)、タグを付けた人と日時(tagger)、メッセージが入っています。

軽量タグも作って比べます。

console
$ git tag v1.2.0-light

$ git cat-file -t v1.2.0-light
commit

$ git show --stat v1.2.0-light
commit 0edd44aff4507c1cf1cd64edbe0358d702e42bfa
Author: Neko <neko@example.com>
Date:   Wed Nov 11 10:30:00 2026 +0900

    1.2.0 の準備

 app.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

軽量タグの名前は、コミットを直接指しています。git show にも Tagger: の行は出ず、誰がいつタグを付けたかは残りません。

注釈付きタグは、名前がタグのオブジェクト 093f427 を指し、それがコミット 0edd44a を指す。軽量タグは、名前がコミット 0edd44a を直接指す
注釈付きタグと軽量タグが指すもの

公式リファレンスには、注釈付きタグはリリース用、軽量タグは自分だけの一時的な目印用だと書かれています。git describe のように、軽量タグを既定では無視するコマンドもあります。リリースのバージョンには -a を付けます。

比べるために作った軽量タグは、git tag -d で消しておきます。

console
$ git tag -d v1.2.0-light
Deleted tag 'v1.2.0-light' (was 0edd44a)

過去のコミットにタグを付ける

タグを付け忘れた過去のリリースにも、あとからタグを付けられます。最後の引数に、タグを付けたいコミットを渡します。ここでは HEAD~2(2つ前)と HEAD~1(1つ前)で指定しました。

console
$ git log --oneline
0edd44a 1.2.0 の準備
f173986 1.1.0 の準備
62e82a6 1.0.0 の準備
f18407a 最初のコミット

$ git tag -a v1.0.0 -m "バージョン 1.0.0" HEAD~2

$ git tag -a v1.1.0 -m "バージョン 1.1.0" HEAD~1

$ git log --oneline --decorate
0edd44a (HEAD -> main, tag: v1.2.0, origin/main) 1.2.0 の準備
f173986 (tag: v1.1.0) 1.1.0 の準備
62e82a6 (tag: v1.0.0) 1.0.0 の準備
f18407a 最初のコミット

すでにある名前でタグを作ろうとすると、エラーで止まります。

console
$ git tag -a v1.2.0 -m "やり直し"
fatal: tag 'v1.2.0' already exists

公式リファレンスの「On Re-tagging」の節では、まだどこにも送っていないタグなら -f を付けて付け直してよいとしています。一方、プッシュしたあとなら、ほかの人がもう古いタグを持っているかもしれないので、X.1 のような別の名前にするのが無難なやり方だとしています。

タグの一覧を、バージョンの順に並べる

app.txt を 1.10.0 にしてコミットし、そのコミットに v1.10.0 を付けてから、一覧を見ます。

console
$ echo "version: 1.10.0" > app.txt

$ git commit -q -am "1.10.0 の準備"

$ git tag -a v1.10.0 -m "バージョン 1.10.0"

$ git tag
v1.0.0
v1.1.0
v1.10.0
v1.2.0

git tag の一覧は、既定では名前を文字として並べた順です(設定 tag.sort がないとき)。そのため v1.10.0 が v1.2.0 より前に来ます。バージョンの順に並べたいときは、--sort=v:refname を使います。v:refname の前に - を付けると逆順になり、新しいバージョンが上に来ます(公式リファレンスの –sort の説明)。

console
$ git tag --sort=-v:refname
v1.10.0
v1.2.0
v1.1.0
v1.0.0

名前の一部で絞り込むときは -l にパターンを渡し、メッセージも見たいときは -n を付けます。

console
$ git tag -l "v1.1*"
v1.1.0
v1.10.0

$ git tag -n
v1.0.0          バージョン 1.0.0
v1.1.0          バージョン 1.1.0
v1.10.0         バージョン 1.10.0
v1.2.0          バージョン 1.2.0

いまのコミットが、どのタグから何コミット進んだか

git describe を使うと、いまのコミットにいちばん近いタグが分かります。タグを付けたコミットの上では、タグの名前だけが出ます。

console
$ git describe
v1.10.0

コミットを1つ足してから、もう一度実行します。

console
$ echo "memo" > memo.txt

$ git add memo.txt && git commit -q -m "メモを追加"

$ git describe
v1.10.0-1-g284a895

v1.10.0 から1コミット進んだ、284a895 のコミットという意味です。g は git の頭文字で、ハッシュの前に付きます(git describe の公式リファレンス)。

タグをリモートに送る

タグは、ふつうの git push では送られません(Pro Git 日本語版の「タグ」)。ブランチだけをプッシュしてから、リモートにあるタグを git ls-remote --tags で見ると、何も出ません。

console
$ git push origin main
To ../remote.git
   0edd44a..284a895  main -> main

$ git ls-remote --tags origin

1つずつ送る

タグの名前を指定してプッシュすると、そのタグだけが送られます。

console
$ git push origin v1.10.0
To ../remote.git
 * [new tag]         v1.10.0 -> v1.10.0

$ git ls-remote --tags origin
82522d62b944ef0f929cce61a6abe30874f46ca4	refs/tags/v1.10.0
b5b3f8717aa900171bf4b6b09056191e5cd4ca82	refs/tags/v1.10.0^{}

refs/tags/v1.10.0 がタグのオブジェクト、^{} の付いた行が、タグをたどった先のコミットです(リビジョンの指定方法の公式リファレンス)。

注釈付きタグをまとめて送る –follow-tags

--follow-tags を付けてブランチをプッシュすると、送るブランチからたどれるコミットに付いた注釈付きタグのうち、リモートにまだないものも一緒に送られます(git push の公式リファレンス)。

console
$ git push --follow-tags origin main
To ../remote.git
 * [new tag]         v1.0.0 -> v1.0.0
 * [new tag]         v1.1.0 -> v1.1.0
 * [new tag]         v1.2.0 -> v1.2.0

送られるのは注釈付きタグだけです。軽量タグ local-only を作ってから同じ操作をすると、何も送られませんでした。

console
$ git tag local-only

$ git push --follow-tags origin main
Everything up-to-date

すべてのタグを送る –tags

--tags を付けると、軽量タグも含めて、手元のタグがすべて送られます。

console
$ git push origin --tags
To ../remote.git
 * [new tag]         local-only -> local-only
注意

--tags は、自分だけの目印のつもりで付けた軽量タグもリモートに送ります。リリースのタグだけを送りたいときは、名前を指定するか、--follow-tags を使います。

間違えて送ったタグを消す

手元のタグは git tag -d、リモートのタグは git push origin --delete で消します。手元で消しただけでは、リモートのタグは残ります。

console
$ git tag -d local-only
Deleted tag 'local-only' (was 284a895)

$ git push origin --delete local-only
To ../remote.git
 - [deleted]         local-only

$ git ls-remote --tags origin
5f681d6e8220f2584ccdd45eda4fffe6fa805352	refs/tags/v1.0.0
62e82a67302f6a3e034f9d293d9b6abad9f6cb26	refs/tags/v1.0.0^{}
855e6c05fc2181e4babe87adb707c2eef0ae5f91	refs/tags/v1.1.0
f17398600c110983fe79287d3d768b96d827bbec	refs/tags/v1.1.0^{}
82522d62b944ef0f929cce61a6abe30874f46ca4	refs/tags/v1.10.0
b5b3f8717aa900171bf4b6b09056191e5cd4ca82	refs/tags/v1.10.0^{}
093f427a718c396a5c11ba369d3a7947994516a0	refs/tags/v1.2.0
0edd44aff4507c1cf1cd64edbe0358d702e42bfa	refs/tags/v1.2.0^{}

リモートには、リリースの4つのタグだけが残りました。

タグのバージョンを取り出す

リモートをクローンすると、タグも一緒に入ってきます。git switch --detach にタグの名前を渡すと、そのバージョンの中身を取り出せます。

console
$ git clone -q ../remote.git ../clone && git -C ../clone tag
v1.0.0
v1.1.0
v1.10.0
v1.2.0

$ git -C ../clone switch -q --detach v1.0.0 && git -C ../clone status | head -1 && cat ../clone/app.txt
HEAD detached at v1.0.0
version: 1.0.0

HEAD detached at v1.0.0 は、ブランチではなくタグの指すコミットにいる状態です。app.txt は 1.0.0 のときの中身になりました。

​Posted by 86