写给github新人,如何下载并运行一个Github项目

【写在前面】
对于庞大的开源代码来说,能在自己电脑上跑起来就是成功的一半,剩下的一半就是带着宝贵的好奇心一行行消化这些大佬代码。曾三次有过阅读githu开源项目的想法,但是苦于有限的英文水平,有限的国内网络,和复杂而庞大的代码,连代码都运行不了,看着一大片报错自然生不出读源码的念想,故几次被劝退。
因此这篇文章写给想要入坑github的新人们,帮助他们成功运行出第一个项目,获得入门的成就感

【项目有关】
halo,基于H2数据库的个人独立博客系统(可能是因为H2不需要单独安装,而MySQL得额外配置),习惯写博客的同学可以把这个博客作为私人笔记本甚至是私人日记本

【工具与资源】
GitHub项目源码:https://github.com/halo-dev/halo
开发工具:IntelliJ IDEA
相关库与包与依赖:太多了…使用idea可以自动导入

【运行步骤】
1,登录github,尽量连接v/p/n,没有账号则进行注册

2,gihub界面左上角搜索 halo,而后选择最高星的首个项目
tip:这里有一个高级搜索的技巧:使用关键字 “in:description 关键词” + “star:>星数” 可以精准地搜索

写给github新人,如何下载并运行一个Github项目_第1张图片
写给github新人,如何下载并运行一个Github项目_第2张图片

3, 进入项目源码后,粗略地阅读代码文件,查看其项目结构和项目管理工具
由倒数第4个文件bulid.gradle可以得知,halo系统是基于gradle管理的,其他项目管理工具还有xml

写给github新人,如何下载并运行一个Github项目_第3张图片

4, 克隆源码
第一种方式:打开git命令行,输入:git clone https://github.com/halo-dev/halo.git
第二种方式:点击Download Zip,下载压缩包后解压

写给github新人,如何下载并运行一个Github项目_第4张图片
成功下载的最终项目文件:
写给github新人,如何下载并运行一个Github项目_第5张图片

5,打开idea,点击import project,输入项目文件的地址,再选择gradle启动(我们已经知道代码是基于gradle管理)等待项目导入(第一次导入过程较慢)
写给github新人,如何下载并运行一个Github项目_第6张图片
写给github新人,如何下载并运行一个Github项目_第7张图片
导入成功
写给github新人,如何下载并运行一个Github项目_第8张图片

6,导入成功后点击右上角application(绿色箭头),启动项目,启动时间长短与电脑配置好坏相关

tip:若绿色箭头呈灰色无法点击 解决方案:右侧栏gradle ==》 Tasks ==》 application ==》 bootRun

写给github新人,如何下载并运行一个Github项目_第9张图片

7, 编译成功后,找到网址 ,在浏览器输入网址就大功告成了
tip:网址1:是供其他用户观看的网址。 网址2:是供自己(admin)管理博客的网址

写给github新人,如何下载并运行一个Github项目_第10张图片


8,我的报错与解决方案:

报错:打开网址后显示404写给github新人,如何下载并运行一个Github项目_第11张图片
bug位置:anatole子文件未成功下载导入
写给github新人,如何下载并运行一个Github项目_第12张图片
解决方案:使用gitzip for githup(chrome插件) 或者 DownGit在原网站下载该文件后导入,这些工具可以指定只下载单个文件
写给github新人,如何下载并运行一个Github项目_第13张图片


【运行后展示】
写给github新人,如何下载并运行一个Github项目_第14张图片写给github新人,如何下载并运行一个Github项目_第15张图片


祝各位入坑愉快。

你可能感兴趣的:(others)