git describe の使い方
近いタグから名前を付ける
書き方
git describe git describe --tags git describe --abbrev=0 git describe --always --dirty
一番近い注釈付きタグと、そこから進んだコミットの数で名前を付けます（v1.2-3-gabc1234）。--tags は軽量タグも使います。
よく使うオプション
| オプション | 意味 |
|---|---|
--tags | 軽量のタグも使う |
--abbrev=0 | いちばん近いタグの名前だけを出す |
--always | タグがなければ、コミットの番号を出す |
--dirty | コミットしていない変更があれば -dirty を付ける |
例
$ git describev1.2-3-g9c1e2f4いちばん近い注釈付きのタグと、そこから進んだコミットの数で名前を付けます。
$ git describe --tags --abbrev=0v1.2いちばん近いタグの名前だけを出します。次の版の番号を決めるときに使います。
$ git describe --always --dirtyv1.2-3-g9c1e2f4-dirtyアプリの版の表示に使います。作業中の変更があると -dirty が付きます。
よくある間違い・注意
- 注釈付きのタグが 1 つもないと「No names found」になります。軽量のタグも使うなら --tags を付けます。
- --depth で clone したリポジトリでは、タグまで辿れず失敗することがあります。
実際に打って練習する
Git コースの Lv56「名を名乗る git describe」で覚えます（第8章 探偵の書斎（履歴を調べる））。ブラウザの中のシミュレーターで、本物と同じように打って確かめられます。
Lv1〜10 は、登録不要・無料で遊べます（それより先はブロンズ以上のプランで遊べます）。