【Git入門】git tagとは？基本をわかりやすく解説！

Gitではわかりやすく参照するためにtag（タグ）を作成することができます。

といった方に向けて、この記事では「git tag」コマンドでtagを作成する方法や一連の操作について解説していきます。

tagを作成する方法についてわかりやすく解説していますので、ぜひ参考にしてください。

git tagとは

「git tag」を一言で言うと「参照しやすいように名前をつける」ためのコマンドです。例えばリリース時にコミットごとにバージョンを付けて管理したい場合（ver1.0 → ver1.1など）などにtagを作成します。git tagコマンドを使用することでタグを簡単に作成することができます。

git tagの書き方

# 注釈なしタグ
git tag [タグ名]

# 注釈付きタグ
git tag -a [タグ名] -m [“コメント“]

tagは「注釈なし」コマンドと、簡単なコメントが付けられる「注釈あり」コマンドがあります。

git tagの使い方

tagの作成

ここではローカルリポジトリでtagを実際に作成してみましょう。以下では注釈なしで「v1.0.0」の名前でtagを作成しています。

$ git tag "v1.0.0"

続いて注釈付きのtagを作成してみます。

$ git tag -a "v1.0.1" -m "add v1.0.1"

注釈付きの場合はオプション「-a」のあとにtag名を指定し、オプション「-m」のあとに注釈を指定します。

tagを一覧で確認する

作成したtagを一覧で確認する場合は、引数なしの「git tag」コマンドを実行します。

$ git tag
v1.0.0
v1.0.1
v1.0.2
v1.0.3
v1.0.4

このように作成されているtagが一覧で表示されます。

tagの内容を確認

tagの内容を確認する場合は「git show」コマンドを使います。

git showの書き方

git show [タグ名]

実際に注釈なし、注釈ありのタグの内容を確認してみます。

注釈なし：

$ git show v1.0.0
commit c059e29d730f043bedf693c4b462123759e51317 (HEAD -> master, tag: v1.0.4, tag: v1.0.3, tag: v1.0.2, tag: v1.0.1, tag: v1.0.0, origin/master)
Author: yamataka <taka@tk-2.local>
Date:   Fri Sep 14 09:28:39 2018 +0900

    はじめてのGit

diff —git a/sample.txt b/sample.txt
new file mode 100644
index 0000000..106287c
— /dev/null
+++ b/sample.txt
@@ -0,0 +1 @@
+Hello Git!

表示される内容は以下の通りです。

注釈あり：

$ git show v1.0.1
tag v1.0.1
Tagger: yamataka <taka@tk-2.local>
Date:   Fri Sep 14 09:50:42 2018 +0900

add v1.0.1

commit c059e29d730f043bedf693c4b462123759e51317 (HEAD -> master, tag: v1.0.4, tag: v1.0.3, tag: v1.0.2, tag: v1.0.1, tag: v1.0.0, origin/master)
Author: yamataka <taka@tk-2.local>
Date:   Fri Sep 14 09:28:39 2018 +0900

    はじめてのGit

diff —git a/sample.txt b/sample.txt
new file mode 100644
index 0000000..106287c
— /dev/null
+++ b/sample.txt
@@ -0,0 +1 @@
+Hello Git!

注釈ありのtagの場合は以下の情報も追加されます。

tagをリモートに反映

ローカルリポジトリで作成したtagをリモートに反映したい場合は「git push」コマンドでtag名を指定します。

git push origin [タグ名]

以下はタグ「v1.0.0」を指定してpushしています。

$ git push origin v1.0.0
Total 0 (delta 0), reused 0 (delta 0)
To https://github.com/takataka58/sample.git
 * [new tag]         v1.0.0 -> v1.0.0

ローカルリポジトリで作成したtagをまとめてpushしたい場合は「git push —tags」コマンドを実行します。

$ git push —tags
Counting objects: 1, done.
Writing objects: 100% (1/1), 154 bytes | 154.00 KiB/s, done.
Total 1 (delta 0), reused 0 (delta 0)
To https://github.com/takataka58/sample.git
 * [new tag]         v1.0.1 -> v1.0.1
 * [new tag]         v1.0.2 -> v1.0.2
 * [new tag]         v1.0.3 -> v1.0.3
 * [new tag]         v1.0.4 -> v1.0.4

tagの削除

tagを削除したい場合は「git tag」コマンドのオプション「-d」を指定します。

git tag -d [タグ名]

以下では「v1.0.0」を削除しています。

$ git tag -d v1.0.0
Deleted tag ‘v1.0.0’ (was c059e29)

一覧で確認してみると指定したtagが削除されていることがわかりますね！

v1.0.1
v1.0.2
v1.0.3
v1.0.4

そもそもGitについてよくわからない方へ

そもそもGitについてよくわからない人は、以下の記事で基本を解説していますので、参考にしてください！

GitHubとは何かわかりやすく解説！機能や仕組み、メリットも紹介

更新日：2024年3月1日

まとめ

ここではtagを作成する方法について、以下の内容で解説しました。

tagを作成することでコミットの内容をわかりやすく参照することができます。もし、git tagの使い方を忘れてしまったら、この記事を思い出してくださいね！