Hexo+github搭建博客過程中遇見的問題及解決方法


前情提要

使用Hexo和github搭建免費個人博客前提是先要安裝好git、Node.js和Hexo。環境安裝完成后,通過git在本地搭建Hexo博客,最后將博客托管到github即可。

 

一、git的安裝出現的問題

 

1、官網下載git速度很慢,使用百度網盤下載:鏈接: https://pan.baidu.com/s/1FcsQYR7cFNme7Y77pw4xiw 提取碼: ftrp

 

2、配置SSH KEY時用命令   ssh -T git@github.com 查看git認證是否配置成功時報錯   “The authenticity of host 'github.com (13.250.117.223)' can't be established.” 
 

 Are you sure you want to continue connecting (yes/no)?   #這里直接輸入yes回車

 

3、出現fatal:Could not read from remote repository.

 

①如果沒有在github的Settings中添加SHH KEY,去github添加即可。

 

②如果在github中已經添加SHH KEY,把.shh文件夾中的id_rsa和id_rsa.pub兩個文件刪除,重新配置SHH KEY並添加到github就可以了。

 

二、Node.js出現的問題

 

1、安裝cnpm使用國內鏡像、解決卡頓

 

①以管理員身份運行命令提示符

 

②換成阿里源下載

 npm config set registry https://registry.npm.taobao.org

 

③驗證命令,返回http://registry.npm.taobao.org,則說明鏡像配置成功。
 npm config get registry

 

④安裝cnpm

 npm install -g cnpm --registry=https://registry.npm.taobao.org

 

2、npm一直停在"checking installable status"

可能是舊的npm緩存與項目沖突或者修改過倉庫源(阿里源之類的),解決的方法:

sudo npm cache clean

npm config set registry https://registry.npm.taobao.org

 

三、安裝Hexo和搭建本地Hexo博客

 

1、執行命令hexo server,提示:Usage :hexo...提示找不到該指令

在本地生成hexo模板后在輸入hexo server啟動服務器時,提示找不到server指令。這是因為Hexo3.0把服務器獨立成了個別模塊,所以不能直接使用hexo server,必須先安裝hexo-server才可以使用。

安裝命令: 

$ npm install hexo-server --save

 

2、出現"Cannot GET/XXX"錯誤

在Hexo博客中,出現Cannot GET/xxx錯誤便意味着xxx文件未被找到。Cannot GET/xxx錯誤本質是hexo server返回的一個404錯誤。

①判斷博客的public目錄下xxx文件是否存在。
(我的錯誤是 Cannot GET /,因此在public目錄下尋找index.html是否存在。)

②如果說index.html不存在,那么執行hexo c,hexo g重新生成一次,回到步驟1。

③步驟2執行完后index.html仍不存在,執行npm audit fix,查看是否少了什么組件,通過npm install hexo-xxx-xxx 安裝即可。
(我的hexo缺少了hexo-generator-index組件,因此執行npm install hexo-generator-index即可)

④步驟3完成之后,執行hexo c,hexo g重新生成靜態文件。

 

3、No Layout:index.html

當使用 hexo g 命令時,編譯過程會出現警告和錯誤信息。把錯誤信息中的hexo插件和組件安裝完,即可解決問題。

①使用命令查看hexo插件和組件的安裝情況

npm ls             //查看hexo插件安裝情況
npm audit fix      //查看hexo組件的安裝情況

②通過install命令安裝缺失的包和組件

npm install xxx  --save   //xxx為插件和組件名

 

如果安裝完插件和組件,重新執行 hexo g 命令沒有報錯。而在啟動Hexo服務器的時候頁面還是空白的,查看博客目錄下themes目錄下的主題目錄是否為空,為空的話是因為在使用 hexo init 命令在本地生成hexo模板的時候缺少組件或者插件,導致模板生成失敗。在安裝完插件或組件后,刪除博客目錄下的文件,重新使用 hexo init 命令生成模板。配置后打開http://localhost:4000/就不是空白了。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM