文章封面信息图:一条仓库链接旁的五个核对位置,用编号依次标出
阅读口径

分支会动,标签不动,版本号是人给标签起的名字。记住这一句,“该下载哪个”的问题就简单很多。这组概念在

一、分支:一条会移动的指针

分支本质上是一个指向某次提交的指针,随着新提交不断向前移动。默认分支通常叫 main 或 master,是项目当前开发的主线;此外还可能有开发分支、修复分支、为某个版本长期保留的维护分支。因为指针会动,你今天看到的文件,明天可能已经变了。所以“上次下载的还是好的”经常对不上——不是文件被换,而是你站在会往前走的线上。这些名词在托管平台常识栏目里有更完整的解释。分支移动是正常现象;判断项目是否稳定,看的不是默认分支有没有变,而是发布标签是否稳定。关于引用与转述他人内容时的原则,可参照本站编辑规则:四条不随主题放宽的约束,其中有统一约定。

二、标签:钉在某一刻的名字

标签同样指向一次提交,但它不会移动。给某次提交打上 v1.2.0 的标签,等于把那一刻的代码钉住,之后无论主分支走多远,这个标签始终指向同一份内容。所以发布版本几乎都用标签标记,下载标签对应的压缩包,得到的才是确定的副本。标签名理论上可以删掉重打,并非绝对不可变;但正常项目不会随意改动已发布的标签,这是行业默契。

三、版本号:人定的约定,不是技术字段

版本号是打在标签上的文字,常见形式是主版本.次版本.修订号。通行含义是:主版本变化代表不兼容改动,次版本代表新增功能且向后兼容,修订号代表修错。它不是强制规则,只是被广泛接受的约定,所以会有带日期、带构建号、带前缀 v 的各种变体。读版本号要看发布说明,不能凭数字猜兼容性。

四、为什么同一份内容会有多个副本

副本来自四个地方:默认分支的最新状态、某个维护分支的状态、某个标签对应的快照、发行版页面打包好的附件。再加上别人复制出去的镜像与分支,同一个项目在搜索结果里会出现几十个看起来一样的页面。所以别把“内容相同”当成“来源相同”。

五、下载时该怎么选

  1. 01要稳定版本:选标签或发行版,不要选默认分支的压缩包。
  2. 02要最新修复:选默认分支,但要接受它随时可能变化。
  3. 03要复现问题:同时记下标签名与提交编号,只写版本号不够精确。
  4. 04要长期维护:选仍在更新的维护分支,并定期对照发布说明。

六、四个常见误会

  • 标签不等于发行版:前者是代码快照,后者可能附带编译好的附件与说明。
  • 版本号大不代表更新:有些项目按日期编号,有些长期停在 0.x。
  • 分支名没有固定含义:main、dev、stable 只是习惯叫法,要看项目自己的说明。
  • 下载 ZIP 不等于拿到全部:压缩包只含某个分支在打包时刻的内容,不含其他分支与历史。

常见问题

为什么下载的压缩包里没有发行版里的安装程序?

因为两者来源不同。网页上的“下载 ZIP”打包的是某个分支的源码快照,里面只有代码与说明文件;发行版附件是维护者另外上传的构建产物,需要到发行版页面单独下载。想装软件去发行版页面,想读代码用源码快照,两个入口对应两种东西。

标签可以删掉重打,怎么确认拿到的是原始版本?

对照发布说明里记录的提交编号,或用校验值比对附件。标签名本身不是强保证,但“标签名 + 提交编号 + 发布时间”三者一致时,基本可以确认是同一份内容。若项目还提供签名文件,可靠性更高;只有一个孤零零的版本号时,就当作普通快照看待。

七、把三个概念连成一句话

分支回答“现在在做什么”,标签回答“哪一刻被固定下来”,版本号回答“这次固定被叫作什么”。三者叠在一起,才构成一个项目的完整坐标。看页面时按这个顺序读:默认分支最近有没有动静,最新标签是什么时候打的,版本号与发布说明是否对得上。