源代码下载

昨天又帮一个朋友折腾他的源代博客。他想换掉主题里那个老旧的码下轮播图，看中了 GitHub 上一个开源项目。源代我发给他项目主页链接，码下他回了一句：“然后呢？源代没看到下载按钮啊。”

这场景太熟了。码下很多人第一次接触开源项目，源代卡在“下载”这一步。码下不是源代找不到，是码下根本不知道找什么。项目主页上那个绿色的源代 Code 按钮，点开有两个选项：Clone 和 Download ZIP。码下大多数人直接点后者，源代下回来一个压缩包解压，码下扔进项目文件夹，源代能用就行。

但这里有个问题。ZIP 包下载的是当前默认分支的快照，没有版本历史，没有 .git 目录。你没法 git pull 更新，没法切换分支，更没法给项目提 PR。说白了，你拿到的是一张照片，不是一棵能继续生长的树。

我早期也这么干过。2016 年那会儿想给 Octopress 博客换个主题，直接下了 ZIP，改了几个文件，后来原作者更新了主题，我完全不知道怎么合并。只能重新下一遍，再把改过的地方手动抄过去。折腾了三次之后，我学会了用 git clone。

命令行里敲 git clone https://github.com/user/repo.git，得到的是一整个仓库。所有分支、所有提交记录、所有标签，全在本地。想换分支就 git checkout，想更新就 git pull。这才是正经的“源代码下载”。

有人会说，我不写代码，就想要个能跑的程序，ZIP 不是更简单吗？不一定。很多项目在 Releases 页面提供编译好的二进制文件，那才是给非开发者准备的。比如你下个 youtube-dl，去 Releases 里找 .exe 或 .dmg，双击就能用。去下 ZIP 源码包，反而要自己装 Python 环境、装依赖，纯属绕远路。

所以“源代码下载”这四个字，拆开看是两件事。要源码，git clone；要成品，找 Releases。搞混了，轻则多花半小时配环境，重则直接放弃。

还有个坑是分支。GitHub 默认显示 main 或 master，但有些项目的稳定版在 release 分支，开发版在 dev 分支。你直接下默认分支的 ZIP，可能拿到一个半成品。我遇到过好几次，从 main 分支下下来的代码跑不起来，翻 Issues 才发现作者说“请使用 stable 分支”。

更隐蔽的是子模块。有些项目用 git submodule 引用其他仓库，ZIP 包里不包含子模块内容。你解压后编译，报一堆“文件不存在”。这时候得 git clone --recursive，或者 clone 完之后 git submodule update --init。ZIP 用户根本不知道发生了什么。

我现在的习惯是，不管三七二十一，先 git clone。哪怕只是看看代码，clone 下来用编辑器翻一翻，比在网页上点来点去舒服得多。本地有完整历史，想看某行代码什么时候改的，git blame 一下就行。ZIP 包做不到这个。

当然，git 本身有学习成本。但只学 clone、pull、checkout 这三个命令，够应付 90% 的下载场景了。花二十分钟看个入门教程，比每次下 ZIP 再手动合并强太多。

最后说个真事。上周那个朋友，我让他装了 Git，clone 了仓库，切到 dev 分支，跑起来发现轮播图有 bug。他顺手提了个 Issue，作者第二天就修了。他 git pull 一下，问题解决。如果当初下的是 ZIP，他大概还在论坛里发帖问“为什么我的轮播图不动”。

下载源代码，不只是拿文件。是拿到一个能持续跟进、能参与、能回滚的完整工作流。ZIP 包给不了你这个。