Git: git tag 使用小結(給發布版本打標記，切換並修改某個歷史版本)

通常在軟件發布的時候會打一個tag，用於標注這次發布的相關信息, 這樣做的好處是，將來如果這個版本出現了問題，可以通過tag迅速定位到當前版本，進行錯誤修復。

1. 新建tag

$ git tag v1.6

v1.6 就是這個tag的名稱，通常以版本號命名。注意：tag是打在最近的一次Commit記錄上的，比如我最近一次提交記錄的Commit ID是 7fd77215642fe36e73674f604ef49a0097d3c0d3，那么執行完 git tag v1.6命令后，tag就打在了這個Commit ID上。

還可以通過加上 -a 參數來創建一個帶備注的tag, 備注信息由 -m 指定：

$ git tag -a v1.6 -m "publish v1.6 version"

2. 列出已有的tag

$ git tag
v1.0
v1.1
v1.2
v1.3
v1.3-bugfix
v1.5
v1.6

還可以加上 -l 命令使用通配符來過濾tag, 這在tag列表比較多的時候很有用：

$ git tag -l "v1.3*"
v1.3 v1.3-bugfix

3. 同步tag到遠程服務器

$ git push origin v1.6
Total 0 (delta 0), reused 0 (delta 0)
To https://github.com/yongdaimi/AndroidApiTest.git
 * [new tag]         v1.6 -> v1.6

和提交代碼一樣，tag默認創建是在本地的，需要進行推送才能到達遠程服務器，如果要推送本地所有tag,可以使用：

$ git push origin --tags

4. 查看某個tag的詳細信息

$ git show v1.6
commit 7fd77215642fe36e73674f604ef49a0097d3c0d3 (HEAD -> master, tag: v1.6, origin/master, origin/HEAD)
Author: nisha_chen <[e-mail]>
Date:   Fri Oct 25 14:33:05 2019 +0800

    android: update current version to 1.6

diff --git a/app/build.gradle b/app/build.gradle
index 55786a4..b100875 100644
--- a/app/build.gradle
+++ b/app/build.gradle
@@ -6,8 +6,8 @@ android {
         applicationId "com.yongdaimi.android.androidapitest"
         minSdkVersion 21
         targetSdkVersion 28
-        versionCode 5
-        versionName "1.4"
+        versionCode 6
+        versionName "1.6"
         testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
     }
     buildTypes {

使用git show 加上 tag名來查看指定tag的詳細信息。

5. 為歷史版本添加tag

$ git tag v1.1.1 03f98856b1a422b5604fc1337500b756513e785c

利用git log 查看結果：

commit 093dafc3e88d8708fa26ac94919d901024878209 (tag: v1.2)
Author: nisha_chen <[e-mail]>
Date:   Fri Oct 25 10:57:31 2019 +0800

    android: update current version to v1.2

commit 03f98856b1a422b5604fc1337500b756513e785c (tag: v1.1.1)
Author: nisha_chen <[e-mail]>
Date:   Fri Oct 25 10:55:21 2019 +0800

    android: update current version to V1.1

commit b16b7376506439d5dd649a8352e5ccb78b455000 (tag: v1.1)
Author: nisha_chen <[e-mail]>
Date:   Thu Oct 24 18:03:49 2019 +0800

    Bluetooth: Add a interface about scan bluetooth device

也可以使用下列命令實現：

$ git tag -a v1.2 9fceb02 -m "my tag"

9fc3b02 是某次Commit ID的前7位，Git不要求寫全所有的Commit ID數字。

6. 刪除tag

$ git tag -d v1.6
Deleted tag 'v1.6' (was 03f9885)

這樣只是把本地的tag刪除掉了，如果要同時刪除服務器上的tag,可以使用

$ git push origin :refs/tags/v1.6
To https://github.com/yongdaimi/AndroidApiTest.git
 - [deleted]         v1.6

7. 利用tag功能切換並修改某個歷史版本

$ git tag
v1.0
v1.1
v1.2
v1.3
v1.5

這里修改v1.3版本:

$ git checkout -b feature-bugfix-v1.3 v1.3
Switched to a new branch 'feature-bugfix-v1.3'

語法是：git checkout -b [branchName] [tagName], 在 feature-bugfix-v1.3 這個分支上修改完畢后切回 master分支並合並 bugfix 分支：

$ git checkout master
Switched to branch 'master'
Your branch is up to date with 'origin/master'.

$ git merge feature-bugfix-v1.3
Merge made by the 'recursive' strategy.
 test.txt | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 test.txt

參考鏈接：
1. git 打 log
2. git 使用技巧