1. 程式人生 > >Hexo 搭建博客 本地運行 常見報錯及解決辦法

Hexo 搭建博客 本地運行 常見報錯及解決辦法

render error: 錯誤 exp 手動配置 fig.yml 文件中 size server

作為一名在hexo方面的新手,我在使用hexo編輯文檔時遇到了很多問題,hexo generate編譯的時候遇到了各種錯誤。

在此將這些錯誤及其解決方案記錄下來,以便日後查證之用,同時,也可給各位在遇到類似問題時提供一點參考。

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

解決方法,在Hexo 3.0 後server被單獨出來了,需要安裝server,安裝的命令如下:npm install hexo-server –save 安裝此server後再試,問題解決。

2.執行:hexo server,啟動了服務,在瀏覽器輸入本地地址訪問,看到白板和Cannot GET / 幾個字

原因是由於2.6以後就更新了,我們需要手動配置些東西,我們需要輸入下面三行命令:

npm install hexo-renderer-ejs--save

npm install hexo-renderer-stylus--save

npm install hexo-renderer-marked--save

這時候重新啟動本地服務在訪問。

或者: 在空文件夾下,執行hexo init -- npm install

3.localhost:4000 端口被占用,可執行 hexo s -p 5000 修改成5000 端口

4.YAMLException: end of the stream or a document separator is expected at line x, column y:

錯誤說明

缺少分隔符,一般都是因為缺少空格

解決方案

(1)出現這種情況,一般都是缺少空格,在:冒號之後要有空格!檢查x行y列附近的冒號,其之後是否跟了空格。

(2)仔細檢查_config.yml文件中所有冒號後面的空格,格式很嚴格,必須是只有一個,半角。不管是多了還是少了都會報錯,這是yml解釋器所定義的語法。如果不確定的話,將輸入法調整到英文模式,刪除所有冒號後面的空格重新輸入,不要使用Tab。

5.ValidationError: ‘null’ is not a string!

錯誤說明

一般都是因為文章無內容,可能是因為在這篇博客文章中,有某些屬性沒有填寫,比如author屬性,tag屬性,categories屬性等,導致該屬性是空的,即null

,所以報錯。
友情提示:如果你是用MarkdownPad 2來進行博文寫作,可能在打開該md文件之後,對文件名進行了修改,導致出現了兩篇文章。就會出現錯誤。

解決方案

既然是屬性缺失,那就把為空的那個屬性給補上吧,仔細找找

6.執行hexo g命令後,報錯:incomplete explicit mapping pair; a key node is missed

解決方案:

主題目錄下所有yml文件中所有有空格的字段都用雙引號括起來,尤其註意languages下面的yml文件。


技術分享

Hexo 搭建博客 本地運行 常見報錯及解決辦法