Git 标签 tags 和 GitHub 版本 releases

一、Git 标签 tags

标签 tag 是某个提交 commit 的指针，一个提交可以有多个标签。

1.1 git tag 查看仓库中所有分支的全部标签：

mcdx@ubuntu:~/git/flasky$ git tag
10a
10b
10c
10d
11a
11b
11c
11d
11e
11f
11g
11h
    ... ...
    ... ...

如果一个版本在多个分支上都有，那么在多个分支上都能看到这个标签。本地标签存在仓库主目录中的 .git/refs/tags 目录下。

1.2 git show [标签名] 查看某个标签的详情，举例查看标签 16a 的详情：

mcdx@ubuntu:~/git/flasky$ git show 16a
commit 59499244f764a67ba6045c3f6ad9dfdb95068a9c
Author: Miguel Grinberg <miguel.grinberg@gmail.com>
Date:   Tue Jul 18 07:55:50 2017 -0700

    Chapter 16: Logging of slow database queries (16a)

diff --git a/app/main/views.py b/app/main/views.py
index 68acd9c..5b30b24 100644
    ... ...
    ... ...

1.3 git tag [标签名] [版本号] 对某个版本号创建标签，该命令创建的是轻标签，对当前版本创建标签时可省略版本号：

mcdx@ubuntu:~/git/jpt$ git tag
haha1.1
mcdx@ubuntu:~/git/jpt$ git tag haha1.2
mcdx@ubuntu:~/git/jpt$ git tag
haha1.1
haha1.2

一个版本号能否创建多个标签？可以的，虽然没啥实际意义：

mcdx@ubuntu:~/git/jpt$ git tag haha1.3
mcdx@ubuntu:~/git/jpt$ git tag
haha1.1
haha1.2
haha1.3

1.4 git tag [标签名] -m '[备注信息]' [版本号] 加一个 -m 参数创建备注标签或者叫附注标签，同样对当前版本创建标签时可省略版本号：

mcdx@ubuntu:~/git/jpt$ git tag xixi1.1 -m 'fuzhubiaoqian'
mcdx@ubuntu:~/git/jpt$ git tag
haha1.1
haha1.2
haha1.3
xixi1.1
mcdx@ubuntu:~/git/jpt$ git show xixi1.1 
tag xixi1.1
Tagger: Manchangdx <1195581533@qq.com>
Date:   Wed Feb 13 13:49:39 2019 +0800

fuzhubiaoqian

commit ff4e669a7aad849d5379e874390be98fcc026feb
Author: LouPlus <34020606+LouPlus@users.noreply.github.com>
    ... ...
    ... ...

1.5 git tag -d [标签名] 删除标签：

mcdx@ubuntu:~/git/jpt$ git tag
haha1.1
haha1.2
haha1.3
xixi1.1
mcdx@ubuntu:~/git/jpt$ git tag -d haha1.3
已删除标签 'haha1.3'（曾为 ff4e669）
mcdx@ubuntu:~/git/jpt$ git tag
haha1.1
haha1.2
xixi1.1

1.6 git push origin [标签名] 推送标签到远程仓库，也就是 GitHub 上：

mcdx@ubuntu:~/git/jpt$ git push origin haha1.1
Username for 'https://github.com': Manchangdx
Password for 'https://Manchangdx@github.com': 
对象计数中: 3, 完成.
压缩对象中: 100% (2/2), 完成.
写入对象中: 100% (3/3), 291 bytes | 0 bytes/s, 完成.
Total 3 (delta 1), reused 0 (delta 0)
remote: Resolving deltas: 100% (1/1), completed with 1 local object.
To https://github.com/LouPlus/jpt
 * [new tag]         haha1.1 -> haha1.1

这个标签 haha1.1 是本地分支 dev 中的最新提交的标签，虽然远程仓库里没有这个分支，更没有这个版本号，但标签却可以成功推送。推送标签成功后，在 GitHub 仓库里会新增一个 tag 和对应的 release：

1.6 GitHub 仓库新增 release 截图

1.7 git push origin --tags 推送全部本地仓库标签至远程仓库：

mcdx@ubuntu:~/git/jpt$ git push origin --tags 
Username for 'https://github.com': Manchangdx
Password for 'https://Manchangdx@github.com': 
对象计数中: 1, 完成.
写入对象中: 100% (1/1), 166 bytes | 0 bytes/s, 完成.
Total 1 (delta 0), reused 0 (delta 0)
To https://github.com/LouPlus/jpt
 * [new tag]         haha1.2 -> haha1.2
 * [new tag]         xixi1.1 -> xixi1.1

1.8 git push origin :ref/tags/[标签名] 删除远程仓库的标签：

mcdx@ubuntu:~/git/jpt$ git push origin :refs/tags/haha1.2
Username for 'https://github.com': Manchangdx
Password for 'https://Manchangdx@github.com': 
To https://github.com/LouPlus/jpt
 - [deleted]         haha1.2

1.8 删除标签成功后，GitHub 页面的截图

1.9 git fetch --tags 刷新本地隐式分支顺便刷新了本地标签，此命令加 -p 会清除无效的本地隐式分支，但不会清除未推送到远端的本地标签，因为标签都是显式的。另外 git pull 命令也会拉取远程标签到本地。

二、GitHub 版本 releases

如今我们可以兴奋地宣布发布一个软件产品的版本，发布过程就是一个将软件交付给最终用户的工作流。版本是具有修改日志和二进制文件的一类对象，它们提供了 Git 工作流之外的完整项目历史，它们也可以从存储库的主页上被访问。

发布版 release 附带发布说明和下载软件或源代码的链接。按照许多 Git 项目的约定，发布版本与 Git 的标签 tag 绑定。您可以使用现有的标签，或者让 release 在发布时创建标签。

release 是具有修改日志和二进制文件的一级对象，它可以代表超出 Git 架构本身的一个特定时间点之前的所有项目历史。也就是通过 release，不但能够通过源码体现出项目历史，还能通过已经编译好的二进制文件来进一步描述此时的项目状态。“超出 Git 架构本身” 的意思则在于，Git 本身只能记录项目修改，本质上不适合将编译好的项目二进制文件记录下来。而通过 release 则把项目二进制文件保存了下来，方便用户下载，也方便查找特定版本。

创建 release 需要通过源码托管商的网页操作界面来进行，一般会要求填写 tag 名、分支以及相应的发布说明，还可上传编译好的程序、打包好的文件等。

标签是 git 中的概念，而 release 则是 Github、码云等源码托管商所提供的更高层的概念。也就是说 git 本身是没有 release 这个概念的，只有 tag。两者之间的关系则是，release 基于 tag，为 tag 添加更丰富的信息，一般是编译好的文件。

release 是源码托管商对 Git 的 tag 功能的增强。通过 Git 提供的 tag 功能，我们可以给项目进行版本标识，以识别特定的版本，如 v0.1.0、v1.0.0 等。而通过源码托管商提供的 release 功能，在 tag 的基础上我们可以添加编译好的二进制文件等，如 .deb、.exe 等给特定的版本提供更多的信息，方便用户，也方便后期查找特定版本的程序。

报错
In Unix systems the end of a line is represented with a line feed (LF). In windows a line is represented with a carriage return (CR) and a line feed (LF) thus (CRLF).

解决办法