【保存版】TortoiseGitでGitHubにタグを作成・公開する方法（v0.1.0の例）

この記事でわかること

• TortoiseGitでタグ（v0.1.0など）を作成する方法
• GitHubにタグをPushして公開する方法
• **注釈付きタグ（annotated）と軽量タグ（lightweight）**の違い
• タグの削除・付け直しとよくあるつまずき

前提

• Windows＋TortoiseGitインストール済み
• GitHubからクローン済みのローカルリポジトリ（origin がGitHub）
• タグを付けたいコミットが既に存在（コミット未反映の場合は先にコミット）

用語メモ

• 注釈付きタグ（annotated）：作成者/日付/メッセージが残る。リリース用途に最適
• 軽量タグ（lightweight）：名前だけ付く簡易版。履歴情報が少ない

Step 1. タグを作成する

方法A：作業フォルダから直接

1. 対象リポジトリの作業フォルダを右クリック → TortoiseGit → Create Tag…
2. ダイアログ設定
   • Tag name：v0.1.0
   • Message：FUnity v0.1.0（リリース概要）
   • Select commit：既定は HEAD。過去コミットに付けるなら Browse… で選択
   • （任意）Sign tag（GPG署名）
3. OK で作成

方法B：ログからピンポイントで

1. フォルダ右クリック → TortoiseGit → Show log
2. タグを付けたいコミットを右クリック → Create Tag…
3. Tag name / Message 入力 → OK

迷いがあれば 方法B（ログからコミットを選ぶ）が安全。

Step 2. タグをGitHubへPushする

1. フォルダ右クリック → TortoiseGit → Push…
2. Remote：origin（GitHub）
3. 次のいずれかでタグを送信
   • Push all tags（未Pushのタグをまとめて送る）
   • または Refspecs に refs/tags/v0.1.0:refs/tags/v0.1.0 を追加して個別送信
4. OK（Push） → Success を確認

コツ：初回は Push all tags が簡単。以降は個別指定でもOK。

Step 3. GitHubでタグを確認＆Release作成

1. GitHubのリポジトリ → Releases → Tags
2. v0.1.0 が見えればOK
3. そのまま Draft a new release でリリースページを作ると、ユーザーに親切
   • タイトル：FUnity v0.1.0
   • 変更点：箇条書き
   • Publish release

Unity Package Manager で配布する場合のURL例（サブフォルダ型）：

https://github.com/oco777/FUnity.git#v0.1.0

うまくいかないときのチェックリスト

• タグ名のタイポ：v0.1.0 と v0.1.O（ゼロ/オー）に注意
• Pushの対象不足：Push all tags にチェック or Refspecsでタグ明記
• Remoteミス：origin（GitHub）に送っているか
• 権限エラー：GitHubの権限/トークン/2FA設定を確認
• ローカル未更新：Pull で最新にしてからタグ作成がおすすめ

タグの削除・付け直し（誤操作したとき）

ローカルのタグを削除

1. フォルダ右クリック → TortoiseGit → Browse References
2. refs/tags/v0.1.0 を右クリック → Delete → OK

リモート（GitHub）のタグを削除

1. フォルダ右クリック → TortoiseGit → Push…
2. Refspecs に :refs/tags/v0.1.0（左辺を空にすると削除）を追加 → Push

付け直し

• 正しいコミットに対して Create Tag… → Push をやり直す

Refspec例：

• 追加：refs/tags/v0.1.0:refs/tags/v0.1.0
• 削除：:refs/tags/v0.1.0

Annotated vs Lightweight（どっちを使う？）

• Annotated（推奨）
  • 作成者/日時/メッセージを保持 → リリース管理に最適
  • TortoiseGitの「Create Tag…」でMessageを入れる＝注釈付き
• Lightweight
  • ただの“名札”。履歴が乏しい → ラボ用途や一時目印に

公開リリースには Annotated 一択。

運用の小ワザ

• セマンティックバージョニング（SemVer）：vMAJOR.MINOR.PATCH（例：v0.1.0）
• CHANGELOG → タグ → GitHub Release の順で毎回統一すると迷わない
• リリース後は main の version を次版（例：0.2.0-alpha.0）へ上げて開発継続

まとめ

• 右クリックだけでタグ作成→Pushまで完結（TortoiseGit）
• リリース用途は Annotated タグで
• つまずいたら Push対象（tags） と Remote を再確認
• GitHub Release 作成までやるとユーザーに優しい

最短チートシート

1. Create Tag…：v0.1.0、Message 入力 → OK
2. Push…：origin、Push all tags → OK
3. GitHub Releases → Tags を確認（必要なら Release 作成）