如何在本地克隆 GitHub 仓库,手把手教你下载项目代码

什么是克隆 GitHub

你是不是在网上看到一个很酷的开源项目,想把它弄到自己电脑上跑一跑?这时候就需要“克隆”这个操作。简单说,克隆就是把 GitHub 上的整个项目原封不动地复制到你的电脑里,包括代码、文档、配置文件等等。

比如你想装个自动记账的小工具,发现 GitHub 上有个现成的项目,接下来要做的第一件事就是把它克隆下来。

准备工作:安装 Git

克隆仓库得靠 Git 这个工具。没装的话,先去官网下载安装包,Windows 和 Mac 都有对应版本。装完打开命令行(Windows 用户可以用 Git Bash),输入下面这句看看有没有反应:

git --version

如果显示了版本号,比如 git version 2.35.1,那就说明装好了。

获取仓库地址

打开你要克隆的 GitHub 项目页面,找那个绿色的 “Code” 按钮。点开后会弹出一个链接,一般是以 https:// 开头的,比如:

https://github.com/username/project-name.git

把这个地址复制下来,后面要用。

开始克隆

打开终端或 Git Bash,先切换到你想存放项目的文件夹。比如你想放在桌面的 code 目录下:

cd ~/Desktop/code

然后执行克隆命令:

git clone https://github.com/username/project-name.git

回车后,你会看到一堆下载信息,最后提示 “Cloning into... done”。这时候去看你的文件夹,项目已经完整下载好了。

小技巧:换源加快速度

有时候从 GitHub 下载特别慢,尤其是国内网络。可以试试把 github.com 换成 ghproxy.com 的镜像:

git clone https://ghproxy.com/https://github.com/username/project-name.git

这个中转服务能显著提升下载速度,适合网络不太稳的情况。

克隆完成后做什么

项目下好后,进到文件夹里看看 README.md 文件,通常会写清楚怎么安装依赖、怎么运行程序。比如很多 Python 项目需要先执行:

pip install -r requirements.txt

再运行主程序。别急着乱改代码,先把项目跑起来再说。

以后想更新最新代码,只要进入项目目录,运行:

git pull

就能拉取最新的改动了。