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

本文解释版本库为什么不适合存放所有文件,以及文件放在不同位置时,可核对性会有什么变化。文中不涉及任何具体项目的下载地址。

一、版本库存的是改动,不是成品

版本库的设计目标是记录文本的每一次变化,并且能随时回到任意一个历史版本。为了做到这一点,它按行比对、按差异存储。文本文件改一行只存一行,代价很小;而图片、视频、压缩包是二进制,改一个字节,整个文件在库里的表示就变了,历史里会多出一份完整副本。一个几十 MB 的安装包更新十次,仓库体积就可能涨到几百 MB,而其中绝大部分是你永远不会再看的旧版本。

二、平台的限制与项目自己的选择

多数托管平台对单文件大小、仓库总体积都有上限,超过之后推送会被拒绝。于是项目会把大文件挪到两个地方:一是发行版附件,它不进入版本历史,每次发布单独上传;二是外部对象存储或网盘,仓库里只留一个下载链接。前者仍然在平台内,能看到上传者与发布时间;后者一旦离开平台,链接是否有效、文件是否被替换,都不再受平台约束。这就是为什么同样叫“下载”,可靠性差别很大。

三、位置不同,能核对的东西不同

源码在版本库里,可以看每一行是谁改的;发行版附件在平台内,可以看发布账号与校验值;外部存储的文件,只能看链接本身和提供者的说法。三者不是优劣关系,而是适用场景不同:需要审计就用源码,需要开箱即用就用附件,需要分发超大素材才用外部存储。读者要建立的习惯是——看到下载链接时先问一句“这个文件放在哪”,答案决定了你还能核对什么。

可执行检查单

  1. 01下载前确认文件位置:版本库、发行版附件,还是站外存储。
  2. 02站外链接要单独记录来源与获取时间,它比平台内附件更容易失效。
  3. 03拿到附件后核对体积与校验值,与自己预期的一致再使用。

一个常见问题

为什么下载到的文件和仓库里看到的对不上?

常见原因有三个:发行版附件是构建产物,源码需要编译才会得到同样的程序,版本号不同结果自然不同;下载的是某个分支的快照,而不是标签对应的发布版本;文件来自站外存储,提供者上传的可能是另一份修改过的副本。排查顺序是先确认下载入口,再确认版本号,最后比对校验值。

看到下载链接,第一个该问什么?

文件放在哪里,决定了它的可信度上限。版本库里的内容有历史可查,发行版附件有发布账号可查,站外存储只有链接可查。这不是说站外存储一定有问题——大型素材、数据集、视频演示确实需要它——而是说,当一份文件的来源只剩一个链接时,你需要的其他佐证就要更多:发布者是谁、有没有校验值、有没有人在议题区反馈过。养成先问位置的习惯,后面很多疑问会自动消解。