寫給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:>星數” 可以精準地搜索

在這裏插入圖片描述
在這裏插入圖片描述

3, 進入項目源碼後,粗略地閱讀代碼文件,查看其項目結構和項目管理工具
由倒數第4個文件bulid.gradle可以得知,halo系統是基於gradle管理的,其他項目管理工具還有xml

在這裏插入圖片描述

4, 克隆源碼
第一種方式:打開git命令行,輸入:git clone https://github.com/halo-dev/halo.git
第二種方式:點擊Download Zip,下載壓縮包後解壓

在這裏插入圖片描述
成功下載的最終項目文件:
在這裏插入圖片描述

5,打開idea,點擊import project,輸入項目文件的地址,再選擇gradle啓動(我們已經知道代碼是基於gradle管理)等待項目導入(第一次導入過程較慢)
在這裏插入圖片描述
在這裏插入圖片描述
導入成功
在這裏插入圖片描述

6,導入成功後點擊右上角application(綠色箭頭),啓動項目,啓動時間長短與電腦配置好壞相關

tip:若綠色箭頭呈灰色無法點擊 解決方案:右側欄gradle ==》 Tasks ==》 application ==》 bootRun

在這裏插入圖片描述

7, 編譯成功後,找到網址 ,在瀏覽器輸入網址就大功告成了
tip:網址1:是供其他用戶觀看的網址。 網址2:是供自己(admin)管理博客的網址

在這裏插入圖片描述


8,我的報錯與解決方案:

報錯:打開網址後顯示404在這裏插入圖片描述
bug位置:anatole子文件未成功下載導入
在這裏插入圖片描述
解決方案:使用gitzip for githup(chrome插件) 或者 DownGit在原網站下載該文件後導入,這些工具可以指定只下載單個文件
在這裏插入圖片描述


【運行後展示】
在這裏插入圖片描述在這裏插入圖片描述


祝各位入坑愉快。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章