(31) 試著學 Hexo - 番外篇之常見問題

前言

這一篇是完賽後的總結篇，雖然說是總結篇，但其實還是要講一些 Hexo 常見的問題。

小心關鍵字

基本上會建議你在撰寫筆記文章時，盡可能標題不要打到 Hexo 的一些關鍵字，舉例來講，這個問題是先前社群的朋友發生的狀況，他是在標題打 jQuery 這個關鍵字導致出現錯誤，原文。

## jQuery

雖然我自己是沒出現該錯誤，目前想刻意製造關鍵字錯誤也不知道有哪些，但基本上比較常見的錯誤是雙括號（可能是撰寫 Vue 的筆記）

{{}}

如果你沒有使用程式碼區塊(上下三個頓號)而是使用程式碼片段，那麼就會出現錯誤。

但是基本上當你先前執行 hexo s 以及 hexo deploy 時沒有出現任何錯誤，只有在你新增一篇文章之後才出現一些問題，那麼不妨試試關鍵字這邊去下手。

更新文章後 404

這種狀況其實比較常見於你更改了 categories 的大小寫並且你又剛好使用 Git 做版本控制與部屬，而這個原因是 Hexo 在建立一個靜態頁面時，其實會依照 categories 來生成資料夾，而這邊剛剛好其實 Git 對於大小寫並不敏感，因此一開始你可能分類是 SCSS 後來改叫 scss，這時候你再去看編譯出來的資料夾會發現，不管怎樣都是 SCSS。

而這邊最簡單方式就是砍掉該儲存庫重新再上傳，而另一種方式則是去針對 Git 大小寫敏感去調整，這部分就不再說明，可以透過 Google 找到相關解決方式。

想刪除文章

刪除文章的方式其實非常簡單，刪除 .md 檔案並重新部署就好，除此之外也可以將文章改放到 _drafts 資料夾也可以唷。

模擬伺服器之後文章消失

這個問題算是我一直有發生的狀況，基本上如果你是在 hexo s 的狀況下去編輯文章並一邊看的話，是有一定機率會發生你當前撰寫的文章突然一片空白，至於這個問題我不太清楚原因，但基本上當發生這狀況時可以按下復原按鈕 CTRL+Z 來還原。

當然最好的方式還是避免一邊撰寫一邊使用模擬伺服器。

升級 Hexo 與主題

這個流程算是最繁瑣的一個，基本上就是必須重新建立一個 Hexo 專案，然後將相關的文章移動到新專案（不要懷疑就是這麼麻煩）就這樣。

但是流程太過繁瑣，所以就不再介紹了，之後有機會我再額外寫文章在我的部落格介紹~

部署後沒 CSS 樣式

關於這個問題的話，通常可能是你多了一層結構，例如…

https://hsiangfeng.github.io/blog/

也有一種可能是你的使用者名稱錯誤，你的名稱是 hsiangfeng，但你打成 hsianghexo.github.io 等各種狀況。

這一篇稍微比較短一點，主要是當作完賽的一些常見問題的補充，所以就沒規劃太多內容了哩。

下次再來找機會介紹如何更新 Hexo 與更新 NexT 囉~