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 <nisha_chen@realsil.com.cn>
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 <nisha_chen@realsil.com.cn>
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 <nisha_chen@realsil.com.cn>
Date:   Fri Oct 25 10:55:21 2019 +0800

    android: update current version to V1.1

commit b16b7376506439d5dd649a8352e5ccb78b455000 (tag: v1.1)
Author: nisha_chen <nisha_chen@realsil.com.cn>
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 使用技巧