如何在github下载开源项目到本地（Coding iOS 客户端为例）

一、前言

以 Coding iOS 客户端 为例讲解如何在github下载开源项目到本地

github地址:https://github.com/Coding/Coding-iOS

二、分析

根据项目的Git仓库是否引用其他版本库中的文件Git仓库，就是是否用到git submodule子模组，分为两种方式下载开源项目到本地。

git submodule：项目的版本库在某些情况下需要引用其他版本库中的文件，例如有一套公用的代码库，可以被多个项目调用，这个公用代码库能直接放在某个项目的代码中，而是要独立为一个代码库。好处是不用分别把公用的代码库拷贝到各自的项目中会造成冗余，丢弃了公共代码库的维护历史。

所以，用到git submodule的项目Git仓库必需要把公用代码库也一起下载到本地，否则会找不到指定的文件和目录而报错。

download项目的Git仓库不会连同公用代码库一起下载，clone项目的Git仓库会连同公用代码库一起下载。

1.download项目的Git仓库

对于可以直接以zip压缩包形式download到本地

2.clone项目的Git仓库

用到了git submodule，必需要把 Git仓库 clone 到本地。当然如果项目没有用到git submodule，也可以通过clone下载到本地

由于Coding iOS 客户端用到git submodule，必需要把 Git仓库 clone 到本地，否则直接以zip压缩包形式download到本地，运行（在运行bootstrap脚本下载相应依赖后）会报错找不到指定的文件和目录：error: No such file or directory。

三、clone项目过程

在本地运行终端，切换路径为项目保存路径

在 Coding官方客户端 拷贝Coding的git仓库：https://github.com/Coding/Coding-iOS.git

然后clone到本地

完成clone

四、下载依赖过程

主要是下载第三方框架。

双击运行根目录下的bootstrap脚本

下载相应的依赖

下载依赖后目录情况

至此，项目源码完整下载下来了。