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

20240918031325659

前言

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

20240918031326661

目前有三种常用的方法:

一、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网站和下载开源项目时都需要科学上网,否则无法进行。

20240918031329143

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

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

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

此方法演示完成

Download ZIP
下载
先找到感兴趣的项目(郎哥以开源项目mdclub为例)
20240918031357209
点击Code,然后再点击Download ZIP即可下载

20240918031359574

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

此方法演示完成

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

20240918031451639
END
20240918031452938

本期资源暗号:20230117

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

1、蓝奏云

     node.js.zip

2、123云盘

     资源分享/node.js.zip

3、文叔叔

       node.js.zip

 

阅读剩余
THE END