如何下载并运行GitHub上面的开源项目

如何下载并运行GitHub上面的开源项目 - 第1张图片

前言

GitHub 是一个面向开源及私有软件项目的托管平台,上面有很多优秀的开源项目。当你找到一个感兴趣的项目时,应该如何下载到本地并运行?

如何下载并运行GitHub上面的开源项目 - 第2张图片

目前有三种常用的方法:

一、 Open with GitHub Desktop(在 Github 桌面上打开) 。如果你安装了 GitHub 客户端的话,那么你可以直接 Open with GitHub Desktop,然后就可以在 Github 客户端上直接下载并打开了,但这种方法用得不多。

二、 Download ZIP(下载压缩包) 。可以直接下载项目的压缩包到你的电脑上,也是比较常用的方法。
三、 Clone(克隆) 。代码克隆,工作中基本都是通过 git clone 的方式拉取项目代码。克隆方法又分为两种:HTTPS 和 SSH 。前者无须登录,后者必须登录。
下面将详细介绍每种方法的操作流程(以开源项目 mdclub 为例,项目地址:https://github.com/zdhxiong/mdclub)。文章比较长,可以直接跳到感兴趣的那种方法。
注意:涉及到访问 Github 网站和下载开源项目时都需要科学上网,否则无法进行。

如何下载并运行GitHub上面的开源项目 - 第3张图片

Open with GitHub Desktop
先去 Github 官网注册账号(https://github.com),如果已经有账号就无需再注册了
安装客户端
下载 Github 客户端(https://desktop.github.com)并安装

安装完成后打开客户端,点击 Sign in to Github.com(通过 Github 官网授权登录)

如何下载并运行GitHub上面的开源项目 - 第4张图片
如何下载并运行GitHub上面的开源项目 - 第5张图片
设置 Git 信息
如何下载并运行GitHub上面的开源项目 - 第6张图片
完成
如何下载并运行GitHub上面的开源项目 - 第7张图片
下载项目
到感兴趣的项目(郎哥以开源项目 mdclub 为例)
点击 Code,然后点击 Open with GitHub Desktop
如何下载并运行GitHub上面的开源项目 - 第8张图片
打开 Github 客户端
如何下载并运行GitHub上面的开源项目 - 第9张图片
选择一个合理的文件夹,然后开始克隆
如何下载并运行GitHub上面的开源项目 - 第10张图片
克隆完成
如何下载并运行GitHub上面的开源项目 - 第11张图片
Github 客户端上可以看到项目文件的变化(如果有变化的话)
如何下载并运行GitHub上面的开源项目 - 第12张图片
运行项目
阅读 README.MD 文件(需要先安装 Markdown 编辑器,不会安装点这里。也可以直接在 Github 项目首页查看 MD 文件)
如何下载并运行GitHub上面的开源项目 - 第13张图片
如何下载并运行GitHub上面的开源项目 - 第14张图片
这个文件会告诉我们如何安装部署并运行
各种类型项目的部署方法都不完全相同,所以无法给大家演示具体的操作步骤
这是 mdclub 成功运行之后的效果
如何下载并运行GitHub上面的开源项目 - 第15张图片

此方法演示完成

Download ZIP
下载
先找到感兴趣的项目(郎哥以开源项目 mdclub 为例)
如何下载并运行GitHub上面的开源项目 - 第16张图片
点击 Code,然后再点击 Download ZIP 即可下载

如何下载并运行GitHub上面的开源项目 - 第17张图片

运行
先将下载的压缩包进行解压
如何下载并运行GitHub上面的开源项目 - 第18张图片
阅读 README.MD 文件(需要先安装 Markdown 编辑器,不会安装点这里。也可以直接在 Github 项目首页查看 MD 文件
如何下载并运行GitHub上面的开源项目 - 第13张图片
如何下载并运行GitHub上面的开源项目 - 第14张图片
这个文件会告诉我们如何安装部署并运行
各种类型项目的部署方法都不完全相同,所以无法给大家演示具体的操作步骤
这是 mdclub 成功运行之后的效果
如何下载并运行GitHub上面的开源项目 - 第15张图片

此方法演示完成

Clone - HTTPS
下载
先找到感兴趣的项目(郎哥以开源项目 mdclub 为例)
如何下载并运行GitHub上面的开源项目 - 第16张图片
点击 Code,然后复制 HTTPS 链接
如何下载并运行GitHub上面的开源项目 - 第23张图片
在电脑上你想要存放项目的文件夹空白处右键,点击 Git Bash Here(需要先安装 Git,如果不会安装点这里
如何下载并运行GitHub上面的开源项目 - 第24张图片
输入以下命令,然后回车进行下载
git clone 链接//其中链接是你刚刚复制的 HTTPS 链接
如何下载并运行GitHub上面的开源项目 - 第25张图片
下载完成,同时在文件夹里可以看到新增的项目
如何下载并运行GitHub上面的开源项目 - 第26张图片
运行
项目文件夹
cd 文件夹
如何下载并运行GitHub上面的开源项目 - 第27张图片
运行以下命令,安装依赖环境(如果出现 bash: npm: command not found 的错误提示请转到文末的附录部分,解决后再重新执行命令
npm install
如何下载并运行GitHub上面的开源项目 - 第28张图片
如果出现这样的提示就是无需安装依赖环境(因项目而异)
如何下载并运行GitHub上面的开源项目 - 第29张图片
进入项目文件夹
如何下载并运行GitHub上面的开源项目 - 第30张图片
阅读 README.MD 文件(需要先安装 Markdown 编辑器,不会安装点这里。也可以直接在 Github 项目首页查看 MD 文件)
如何下载并运行GitHub上面的开源项目 - 第13张图片
如何下载并运行GitHub上面的开源项目 - 第14张图片
这个文件会告诉我们如何安装部署并运行
各种类型项目的部署方法都不完全相同,所以无法给大家演示具体的操作步骤
这是 mdclub 成功运行之后的效果
如何下载并运行GitHub上面的开源项目 - 第15张图片
此方法演示完成
Clone - SSH
配置 ssh 公钥
Win+i 打开 Windows 设置,点击 “应用”>“可选功能”
如何下载并运行GitHub上面的开源项目 - 第34张图片
点击 “查看功能”
如何下载并运行GitHub上面的开源项目 - 第35张图片
勾选 OpenSSH 客户端和 OpenSSH 服务器,下一步
如何下载并运行GitHub上面的开源项目 - 第36张图片
安装
如何下载并运行GitHub上面的开源项目 - 第37张图片
打开 CMD,输入以下命令生成公钥
ssh-keygen -t rsa -C "邮箱"//邮箱需要填写你自己的邮箱
如何下载并运行GitHub上面的开源项目 - 第38张图片
需要点击三次回车,出现下面的图案就完成了
如何下载并运行GitHub上面的开源项目 - 第39张图片
可以直接在 Git 上使用以下命令查看公钥内容 (需要先安装 Git,如果不会安装点这里
cat ~/.ssh/id_rsa.pub
如何下载并运行GitHub上面的开源项目 - 第40张图片
也可以直接在管理员目录下寻找公钥文件
如何下载并运行GitHub上面的开源项目 - 第41张图片
进入 Github 官网 (https://github.com),登录账号,先点击右上角的头像,然后点击 Settings
如何下载并运行GitHub上面的开源项目 - 第42张图片
点击 SSH and GPG keys>New SSH key
如何下载并运行GitHub上面的开源项目 - 第43张图片
将之前找到的公钥内容填进去,标题随便填,然后 Add SSH key
如何下载并运行GitHub上面的开源项目 - 第44张图片
公钥添加完成,我们还需要检查一下是否可用
打开 CMD,输入以下代码,回车
ssh -T git@github.com
如何下载并运行GitHub上面的开源项目 - 第45张图片
首次使用需要确认并添加主机到本机 SSH 可信列表。
若返回 Hi XXX! You’ve successfully authenticated...... 内容,则证明添加成功。
如何下载并运行GitHub上面的开源项目 - 第46张图片
下载项目
先找到感兴趣的项目(郎哥以开源项目 mdclub 为例)
点击 Code>SSH> 复制 SSH 链接
如何下载并运行GitHub上面的开源项目 - 第47张图片
在电脑上你想要存放项目的文件夹空白处右键,点击 Git Bash Here(需要先安装 Git,如果不会安装点这里
如何下载并运行GitHub上面的开源项目 - 第24张图片
输入以下命令,回车下载项目
git clone 链接//链接是你刚刚复制的 SSH 链接
如何下载并运行GitHub上面的开源项目 - 第49张图片
下载完成,同时在文件夹里可以看到新增的项目
如何下载并运行GitHub上面的开源项目 - 第50张图片
运行项目
进入项目文件夹
cd 文件夹
如何下载并运行GitHub上面的开源项目 - 第27张图片
运行以下命令,安装依赖环境(如果出现 bash: npm: command not found 的错误提示请转到文末的附录部分,解决后再重新执行命令
npm install
如何下载并运行GitHub上面的开源项目 - 第28张图片
如果出现这样的提示就是无需安装依赖环境(因项目而异)
如何下载并运行GitHub上面的开源项目 - 第29张图片
进入项目文件夹
如何下载并运行GitHub上面的开源项目 - 第30张图片
阅读 README.MD 文件(需要先安装 Markdown 编辑器,不会安装点这里。也可以直接在 Github 项目首页查看 MD 文件)
如何下载并运行GitHub上面的开源项目 - 第13张图片
如何下载并运行GitHub上面的开源项目 - 第14张图片
这个文件会告诉我们如何安装部署并运行
各种类型项目的部署方法都不完全相同,所以无法给大家演示具体的操作步骤
这是 mdclub 成功运行之后的效果
如何下载并运行GitHub上面的开源项目 - 第15张图片
此方法演示完成
附录
出现 bash: npm: command not found 的提示一般是由于没有安装 Node.js
可以先去 CMD 查看 node 的版本,如果没有版本显示或提示 “node 不是内部或外部命令,也不是可运行的程序或批处理文件。”,说明 node.js 还没安装,需要进行安装。
如何下载并运行GitHub上面的开源项目 - 第58张图片
安装方法很简单,直接下载郎哥提供的配套资源 (获取方式在文末),运行 node 安装程序进行安装即可。安装完成后根据文件说明在 CMD 中运行三条命令,以提高 npm 的效率。
如何下载并运行GitHub上面的开源项目 - 第59张图片
再次查看版本,如果可以查到的话,证明已经安装成功,这时可以继续使用 npm 命令了。
如何下载并运行GitHub上面的开源项目 - 第60张图片
补充
运行项目要根据你下载的项目以及 IDE 来选择方法。如果你的项目是用 VUE 写的前端页面而且用的是 IDEA 开发工具,那么你将项目下载下来以后,看看有没有 node_modules 文件,如果有的话就运行 npm install 命令安装依赖环境,然后再运行 npm run dev 命令运行项目。

如何下载并运行GitHub上面的开源项目 - 第61张图片
END
如何下载并运行GitHub上面的开源项目 - 第62张图片

本期资源暗号:20230117

到公众号后台回复以上暗号就可以获取本期资源啦
也可以通过以下文件名直接进入对应的网盘查找
*如果不知道怎么下载,可以到后台回复关键词 “资源” 获取帮助哦*

1 、蓝奏云

     node.js.zip

2 、123 云盘

     资源分享/node.js.zip

3 、文叔叔

       node.js.zip

 

《如何下载并运行GitHub上面的开源项目》留言数:0

发表留言