git tag の使い方

目印をつける

書き方

git tag 名前 [コミット]
git tag -a 名前 -m "メッセージ"
git tag -l "v1.*"
git tag -d 名前

リリースなどのコミットに名前をつけます。-a は作者とメッセージを持つ注釈付きタグ。

よく使うオプション

オプション意味
-a 名前作者と日時とメッセージを持つ、注釈付きのタグを作る
-m "メッセージ"注釈付きのタグのメッセージ
-l "パターン"パターンに合うタグの一覧を出す
-d 名前手元のタグを消す

例

$ git tagv1.0
v1.1
v2.0

タグの一覧を見ます。

$ git tag -a v1.2 -m "1.2 を公開"

今のコミットに、メッセージ付きのタグを付けます。リリースには注釈付きのタグを使うのがふつうです。

$ git tag v1.1.1 3f2a1c9

過去のコミットを指定して、軽量のタグを付けます。

$ git push origin v1.2

タグは git push だけでは送られません。名前を指定して送ります。

$ git tag -l "v1.*"

v1. で始まるタグだけを見ます。

よくある間違い・注意

  • 一度共有したタグを付け直すと、ほかの人の手元と食い違います。間違えたら新しい番号で付け直すほうが安全です。
  • まとめて送るときは git push --tags です。

実際に打って練習する

Git コースの Lv16「目印を立てる git tag」で覚えます(第2章 枝分かれの森(ブランチとマージ))。ブラウザの中のシミュレーターで、本物と同じように打って確かめられます。

Lv1〜10 は、登録不要・無料で遊べます(それより先はブロンズ以上のプランで遊べます)。

Git コマンド一覧(使い方と例)へ戻る