GitHub Releases vs Git Tags：有什麼不同？如何正確使用？

GitHub Releases 與 Git 標籤的關係

GitHub Releases（發佈版本）是基於 Git 標籤（tags） 的 GitHub 特定功能。

GitHub Releases 與 Git 標籤的關係

1. Git 標籤是 Git 的核心功能，與 GitHub 無關。
2. GitHub Releases 是基於 Git 標籤的額外功能，提供：
   • 更友善的 UI 來管理版本發佈
   • 可以上傳二進位檔案（如 zip、編譯好的程式）
   • 用戶可以透過 GitHub 訂閱版本通知

Git 標籤 vs. GitHub Releases

功能	Git 標籤（Git）	GitHub Releases（GitHub）
是否為 Git 內建功能？	✅ 是	❌ 否（GitHub 特有）
可存儲版本資訊？	✅ 是（git tag -a v1.0.0 -m "版本資訊"）	✅ 是（可在 GitHub UI 或 API 編輯）
可上傳二進位檔案？	❌ 否	✅ 是（zip、tar.gz 等）
是否可在 Git Log 中顯示？	✅ 是	❌ 否（僅在 GitHub UI 可見）
需要 GitHub？	❌ 否	✅ 是
是否可透過 CLI 創建？	✅ 是（git tag -a）	✅ 是（gh release create）

如何使用 GitHub Releases

1. 先創建 Git 標籤

git tag -a v1.0.0 -m "版本 1.0.0 - 修正錯誤與效能改進"
git push origin v1.0.0

2. 透過 GitHub UI 創建 Release

• 進入你的 GitHub 倉庫
• 點選 Releases（發佈版本）
• 選擇 「Draft a new release」（建立新發佈）
• 選擇剛剛推送的標籤或建立新標籤
• 填寫發佈說明，並可選擇上傳附件（如 zip、二進位檔案）
• 點擊 「Publish release」（發佈版本）

3. 使用 GitHub CLI 創建 Release（可選）

gh release create v1.0.0 --title "版本 1.0.0" --notes "修正錯誤與效能改進"

如果需要上傳檔案：

gh release create v1.0.0 file.zip --title "版本 1.0.0" --notes "修正錯誤與效能改進"

何時使用 GitHub Releases？

• ✅ 需要更友善的版本管理 UI
• ✅ 需要上傳編譯好的安裝包或 zip 檔案
• ✅ 讓非開發者（終端用戶、客戶）下載版本
• ✅ 搭配 GitHub Actions 進行 CI/CD 自動化發佈

總結

• Git 標籤 是 Git 內建的功能，可用來標記版本。
• GitHub Releases 是 GitHub 提供的額外功能，基於 Git 標籤，並提供 UI、版本說明與檔案上傳。
• 你可以 先創建 Git 標籤，然後在 GitHub 上發佈 Release。
• 使用 GitHub CLI（gh release create）可以自動化發佈。

希望這篇文章對你有所幫助！🚀