git tagで、リリースのバージョンにタグを付ける方法
リリースしたバージョン(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つもありません。
$ 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 でメッセージを渡します。
$ 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 にタグの名前を渡すと、タグの情報と、タグが指すコミットがまとめて出ます。
$ 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 でタグの名前が指すものの種類を見ると分かります。
$ 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)、メッセージが入っています。
軽量タグも作って比べます。
$ 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: の行は出ず、誰がいつタグを付けたかは残りません。

公式リファレンスには、注釈付きタグはリリース用、軽量タグは自分だけの一時的な目印用だと書かれています。git describe のように、軽量タグを既定では無視するコマンドもあります。リリースのバージョンには -a を付けます。
比べるために作った軽量タグは、git tag -d で消しておきます。
$ git tag -d v1.2.0-light
Deleted tag 'v1.2.0-light' (was 0edd44a)
過去のコミットにタグを付ける
タグを付け忘れた過去のリリースにも、あとからタグを付けられます。最後の引数に、タグを付けたいコミットを渡します。ここでは HEAD~2(2つ前)と HEAD~1(1つ前)で指定しました。
$ 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 最初のコミット
すでにある名前でタグを作ろうとすると、エラーで止まります。
$ 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 を付けてから、一覧を見ます。
$ 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 の説明)。
$ git tag --sort=-v:refname
v1.10.0
v1.2.0
v1.1.0
v1.0.0
名前の一部で絞り込むときは -l にパターンを渡し、メッセージも見たいときは -n を付けます。
$ 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 を使うと、いまのコミットにいちばん近いタグが分かります。タグを付けたコミットの上では、タグの名前だけが出ます。
$ git describe
v1.10.0
コミットを1つ足してから、もう一度実行します。
$ 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 で見ると、何も出ません。
$ git push origin main
To ../remote.git
0edd44a..284a895 main -> main
$ git ls-remote --tags origin
1つずつ送る
タグの名前を指定してプッシュすると、そのタグだけが送られます。
$ 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 の公式リファレンス)。
$ 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 を作ってから同じ操作をすると、何も送られませんでした。
$ git tag local-only
$ git push --follow-tags origin main
Everything up-to-date
すべてのタグを送る –tags
--tags を付けると、軽量タグも含めて、手元のタグがすべて送られます。
$ git push origin --tags
To ../remote.git
* [new tag] local-only -> local-only
--tags は、自分だけの目印のつもりで付けた軽量タグもリモートに送ります。リリースのタグだけを送りたいときは、名前を指定するか、--follow-tags を使います。
間違えて送ったタグを消す
手元のタグは git tag -d、リモートのタグは git push origin --delete で消します。手元で消しただけでは、リモートのタグは残ります。
$ 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 にタグの名前を渡すと、そのバージョンの中身を取り出せます。
$ 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 のときの中身になりました。




