Gitタグの基本と使い方を徹底解説!初心者向け完全ガイド

タグ付け(Tagging)は、Gitリポジトリの履歴における特定の時点を記録・管理するための機能です。

Gitリポジトリで作業を続けていくと、コードベースに対して膨大な数の変更を加えることになります。Gitでは、個々の変更を追跡するためにコミットが使用されます。

しかし、バージョンなどリポジトリの履歴における特定の時点を記録したい場合には、Gitのタグ機能を活用するのが最適です。

このチュートリアルでは、具体的な例を交えながら、タグ付けの基本と、git tagコマンドを使ってリポジトリ内のタグを操作する方法を解説します。読み終える頃には、Gitのタグをプロのように扱えるようになっているでしょう。

Gitタグとは

タグとは、Gitリポジトリの履歴内の特定の場所を指し示す参照(refs)のことです。

タグは一般に、リポジトリの履歴における特定の時点を記録し、バージョンリリースを作成するために開発者によって使用されます。例えば、開発者がプロジェクトの新バージョンをリリースする準備ができたときに、プロジェクトにタグを作成することがあります。

本質的に、タグは「変更されないブランチ」のようなものです。タグを作成した後は、そのタグの履歴にコミットが追加されることはありません。代わりに、タグにはタグ作成時点のリポジトリの状態のスナップショットが保存されます。

Gitでサポートされているタグには、次の2種類があります。

• 注釈付きタグ(Annotated tags):Gitデータベースに完全なオブジェクトとして保存されるタグ。
• 軽量タグ(Lightweight tags):名前とコミットへのポインタだけを持つシンプルなタグ。

タグ付けの基本がわかったところで、次にGitでタグを操作する具体的な方法を見ていきましょう。

タグの作成

Gitでタグを操作する前に、まずタグを作成する必要があります。Gitでタグを作成する構文は以下のとおりです。

git tag <name>

「name」パラメータには、作成したいタグの名前を指定します。タグ付けは通常プロジェクトのバージョンを追跡するために使われるため、「v1.2」や「beta-v0.9」のような名前を付けるのが一般的です。

作成したタグは、現在作業中のコミット(HEAD)に適用されます。

注釈付きタグ(Annotated Tags)

注釈付きタグは、Gitデータベースに完全なオブジェクトとして保存されるタグです。注釈付きタグを作成すると、タグを作成した人の名前、メールアドレス、作成日時などのメタデータが保存されます。

さらに、注釈付きタグにはメッセージも保存されます。一般的に、注釈付きタグは軽量タグよりも推奨されています。これは、注釈付きタグに保存されるメタデータが、後々さまざまな用途に役立つからです。

例えば、バージョン管理を誰が担当していたかを後から追跡したい場合には、注釈付きタグに保存されたメタデータが必要になります。

Gitで注釈付きタグを作成する構文は以下のとおりです。

git tag -a <name>

-aフラグは、注釈付きタグを作成することをGitに指示します。「name」パラメータには作成したいタグの名前を指定します。

このコマンドを実行すると、システムのデフォルトのテキストエディタが開き、注釈付きタグのメッセージの入力を求められます。これは、前述のとおり注釈付きタグにはメッセージが保存されるためです。

あるいは、メッセージをコマンドで直接指定することもできます。その場合は以下のコードを使用します。

git tag -a <name> -m <message>

-mオプションは、注釈付きタグにメッセージを追加するために使用します。例えば、「version 1.9」というメッセージ付きで「v1.9」というタグを作成したい場合は、次のコードを使用します。

git tag -a v1.9 -m "version 1.9"

このコマンドを実行すると、「version 1.9」というメッセージが付いた「v1.9」というタグが作成されます。

この方法は、メッセージを指定せずにgit tagを実行するよりも便利です。メッセージを指定しない場合に起動するデフォルトのテキストエディタに入力する手間なく、メッセージを直接指定できるからです。

軽量タグ(Lightweight Tags)

軽量タグを作成するには、先ほど説明した標準のgit tag構文を使用します。例えば、「v1.9.1」という軽量タグを作成したい場合は、次のコードを使用します。

git tag v1.9.1

このコマンドにより、「v1.9.1」という軽量タグが作成されます。軽量タグを作成する際は、タグメッセージを指定する必要はありません。代わりに、新しいタグチェックサムが作成され、プロジェクトの.gitフォルダに保存されます。

プロジェクトのタグ一覧を表示する

大規模なプロジェクトに取り組んでいると、リポジトリに複数のタグ付きバージョンが存在することがあります。プロジェクトに保存されているタグの一覧を取得するには、次のコマンドを使用します。

git tag

このコマンドはタグの一覧を返します。出力例は以下のとおりです。

v1.9.1
v1.9.0
v1.8.11
v1.8.10
v1.8.9
...

また、-lオプションを使用すると、タグをフィルタリングできます。例えば、「v1.8」で始まるすべてのタグの一覧を取得したい場合は、次のコードを使用します。

git tag -l v1.8*

このコマンドでは、-lオプションの後に「v1.8*」を指定しています。これにより、Gitは「v1.8」で始まるすべてのタグの一覧を取得します。アスタリスク(*)は、「v1.8」の後に任意の文字が続くことを意味するワイルドカードです。

このコマンドの出力例は以下のとおりです。

v1.8.11
v1.8.10
v1.8.9
v1.8.8
...

ご覧のとおり、返されたタグはすべて「v1.8」で始まっています。

タグをチェックアウトする

git checkoutコマンドを使用すると、特定のタグが付けられたコミット時点のリポジトリの状態を確認できます。例えば、v1.1の時点のリポジトリを表示したい場合は、次のコードを使用します。

git checkout v1.1

このコマンドを実行すると、リポジトリは「detached HEAD(デタッチドHEAD)」状態に移行します。この状態では、加えた変更はタグ付けされたバージョンのリポジトリには反映されません。代わりに、どのブランチにも関連付けられていない新しい分離コミットが作成されます。

このコマンドを実行することで、v1.1としてタグ付けされたコミット時点のコードベースの状態を確認できます。

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

これまでの例では、現在作業中のコミットにgit tagコマンドでタグを追加する方法を説明してきました。これは、デフォルトではgit tagがHEADコミット(現在表示しているコミット)にタグを作成するためです。

しかし、git tagコマンドを使用すれば、過去のコミットにタグを付けることもできます。その場合は、タグを付けたい特定のコミットの参照を指定します。

例えば、リポジトリの過去のコミットにタグを追加したいとします。そのためには、まずgit logを実行して、最近のコミットの一覧を取得する必要があります。以下はgit logコマンドの実行例です(-pretty=onelineオプションを使用すると、コミットを見やすく1行ずつ表示できます)。

git log --pretty=oneline

このコマンドは以下を返します。

8cd29ae5d04abbdbd856d2c2f55f2b82133903e8 Push new logging feature
2911aae73ed1dd372bcdf8f520b174c3817c818b Initialize logging feature
9646aa785211f3069ce01177da98e23b7890d859 Fix issue #342

ここで、「Fix issue #342」というコミットに「v1.3」というタグを追加したいとします。その場合は、次のコードを使用します。

git tag -a v1.3 9646aa785211f3069ce01177da98e23b7890d859

このコマンドは、指定したコミットに「v1.3」というタグを追加します。この例では、「Fix issue #342」というメッセージが付いたコミットのSHAハッシュを指定しています。

既存のタグを置き換える

各コミットに付けられるタグは1つだけです。コミットに関連付けられたタグを別のタグに置き換えたい場合は、git tagコマンドを使用できます。ただし、既存のタグを上書きするために、-f(強制)オプションを指定する必要があります。

例えば、前の例で使用したコミットに「v1.3.1」というタグを追加したいとします。-fフラグを指定せずに実行すると、エラーメッセージが表示されます。過去のコミットに「v1.3.1」というタグを追加するには、次のコマンドを使用します。

git tag -a -f v1.3.1 9646aa785211f3069ce01177da98e23b7890d859

このコマンドは、コミットに「v1.3.1」というタグを追加し、以前の「v1.3」タグを上書きします。

タグを削除する

Gitでタグを削除するには、-dオプションを使用します。例えば、リポジトリから「v1.3」というタグを削除したい場合は、次のコードを使用します。

git tag -d v1.3
git tag

このコードは以下を返します。

v1.4
v1.2
v1.1

最初のコマンドでリポジトリからタグ「v1.3」が削除されます。2番目のコマンドはタグの一覧を返します。ご覧のとおり、タグの一覧を取得すると、「v1.3」というタグは存在しません。-dオプションでタグを削除したためです。

まとめ

タグ付けは、開発者がGitリポジトリのさまざまなバージョンを追跡するために使用する、Gitの重要な機能です。タグは、開発者が現在表示しているコミットにも、リポジトリ内の既存の過去のコミットにも追加できます。

このチュートリアルでは、具体的な例を交えながら、Gitのタグ付けの基本とgit tagコマンドの使い方を解説しました。これであなたも、プロの開発者のようにgit tagコマンドを使いこなせるはずです!