分支会动,标签不动,版本号是人给标签起的名字。记住这一句,“该下载哪个”的问题就简单很多。这组概念在
一、分支:一条会移动的指针
分支本质上是一个指向某次提交的指针,随着新提交不断向前移动。默认分支通常叫 main 或 master,是项目当前开发的主线;此外还可能有开发分支、修复分支、为某个版本长期保留的维护分支。因为指针会动,你今天看到的文件,明天可能已经变了。所以“上次下载的还是好的”经常对不上——不是文件被换,而是你站在会往前走的线上。这些名词在托管平台常识栏目里有更完整的解释。分支移动是正常现象;判断项目是否稳定,看的不是默认分支有没有变,而是发布标签是否稳定。关于引用与转述他人内容时的原则,可参照本站编辑规则:四条不随主题放宽的约束,其中有统一约定。
二、标签:钉在某一刻的名字
标签同样指向一次提交,但它不会移动。给某次提交打上 v1.2.0 的标签,等于把那一刻的代码钉住,之后无论主分支走多远,这个标签始终指向同一份内容。所以发布版本几乎都用标签标记,下载标签对应的压缩包,得到的才是确定的副本。标签名理论上可以删掉重打,并非绝对不可变;但正常项目不会随意改动已发布的标签,这是行业默契。
三、版本号:人定的约定,不是技术字段
版本号是打在标签上的文字,常见形式是主版本.次版本.修订号。通行含义是:主版本变化代表不兼容改动,次版本代表新增功能且向后兼容,修订号代表修错。它不是强制规则,只是被广泛接受的约定,所以会有带日期、带构建号、带前缀 v 的各种变体。读版本号要看发布说明,不能凭数字猜兼容性。
四、为什么同一份内容会有多个副本
副本来自四个地方:默认分支的最新状态、某个维护分支的状态、某个标签对应的快照、发行版页面打包好的附件。再加上别人复制出去的镜像与分支,同一个项目在搜索结果里会出现几十个看起来一样的页面。所以别把“内容相同”当成“来源相同”。
五、下载时该怎么选
- 01要稳定版本:选标签或发行版,不要选默认分支的压缩包。
- 02要最新修复:选默认分支,但要接受它随时可能变化。
- 03要复现问题:同时记下标签名与提交编号,只写版本号不够精确。
- 04要长期维护:选仍在更新的维护分支,并定期对照发布说明。
六、四个常见误会
- 标签不等于发行版:前者是代码快照,后者可能附带编译好的附件与说明。
- 版本号大不代表更新:有些项目按日期编号,有些长期停在 0.x。
- 分支名没有固定含义:main、dev、stable 只是习惯叫法,要看项目自己的说明。
- 下载 ZIP 不等于拿到全部:压缩包只含某个分支在打包时刻的内容,不含其他分支与历史。
常见问题
为什么下载的压缩包里没有发行版里的安装程序?
因为两者来源不同。网页上的“下载 ZIP”打包的是某个分支的源码快照,里面只有代码与说明文件;发行版附件是维护者另外上传的构建产物,需要到发行版页面单独下载。想装软件去发行版页面,想读代码用源码快照,两个入口对应两种东西。
标签可以删掉重打,怎么确认拿到的是原始版本?
对照发布说明里记录的提交编号,或用校验值比对附件。标签名本身不是强保证,但“标签名 + 提交编号 + 发布时间”三者一致时,基本可以确认是同一份内容。若项目还提供签名文件,可靠性更高;只有一个孤零零的版本号时,就当作普通快照看待。
七、把三个概念连成一句话
分支回答“现在在做什么”,标签回答“哪一刻被固定下来”,版本号回答“这次固定被叫作什么”。三者叠在一起,才构成一个项目的完整坐标。看页面时按这个顺序读:默认分支最近有没有动静,最新标签是什么时候打的,版本号与发布说明是否对得上。