使用hexo+github搭建個人博客遇到過哪些坑

一、

fatal: Could not read from remote repository.
致命:無法讀取遠程存儲庫。
Please make sure you have the correct access rights and the repository exists.
請確保你有正確的訪問權(quán)限和存儲庫的存在。

出現(xiàn)這種錯誤,有可能在配置_config.yml的時候,

deploy:
  type: git
  repo: http://github.com/wapchief/wapchief.github.io.git
  branch: master

repo:設(shè)置了SSH方式連接,在沒有ssh證書的情況下是連接失敗的。解決方法是把ssh,修改為https方式連接。
如果仍報錯,把https改為http。

二、

ERROR Deployer not found: git

fatal: in unpopulated submodule '.deploy_git'

兩個是一個錯誤,未安裝部署工具,或者和之前安裝的版本有沖突
執(zhí)行安裝命令:

npm install hexo-deployer-git --save

如果安裝報錯,就先清除一下再重新安裝

rm -rf .deploy_git
npm install hexo-deployer-git --save

三、

fatal: unable to stat 'node_modules/hexo-deployer-git/node_modules/hexo-fs/node_modules/chokidar/node_modules/anymatch/node_modules/micromatch/node_modules/braces/node_modules/expand-range/node_modules/fill-range/node_modules/is-number/LICENSE': Filename too long

這種情況一般是在執(zhí)行

git add .
git push
git commit

的時候會出現(xiàn)。
報錯提示名字超長,或者路徑超范圍。
解決的方法有很多,選擇升級git。
或者配置git

git config core.longpaths true

四、

相關(guān)工具問題

因為使用hexo+github需要用到多個工具。有時候不確定是不是安裝的問題可以通過下面的命令測試是否安裝成功

node -v
npm -v
git --version
hexo -v

如果都能正常顯示版本信息,證明安裝都沒問題

五、

頁面不能正常顯示,或者404

檢查根目錄下的_config.yml文件是否配置正確,注意變量:后要加空格。
部署的時候,是根據(jù)branch判斷部署的目錄。

部署成功后,無需再使用git命令提交遠程,已經(jīng)自動在遠程生成了頁面文件。

還有種可能是主題有問題,關(guān)于主題可以去官網(wǎng)找,也可以去github,搜hexo theme。一般只要是用來搭建博客的都會有使用教程。

六、

關(guān)于分支和更換電腦問題

由于安裝hexo的時候只在本地生成。而部署的時候只是把public目錄里的文件和相關(guān)配置上傳到github。
要想在遠程也能管理,需要創(chuàng)建新的分支來存放源代碼。

或者通過其他第三方托管平臺來托管源碼,像coding,碼云等都可以。
在github上托管是公共的,如果需要安全也可以這個辦法。

如果使用github分支,則使用

git fetch && git checkout hexo

在本地創(chuàng)建一個新的分支并推送到遠程倉庫,
然后

git add .
git commit -m '提交說明'
//強制提交到hexo分支
git push -f origin hexo

注意:在其他設(shè)備上克隆的時候,建議克隆下來之后把隱藏文件.deploy_git文件刪除,否則容易沖突。

如果有其他問題可以,留言給我。看到一定會回復(fù)。
后面如果有新的問題,我也會在這篇文章中更新。


使用hexo+github免費搭建個人博客網(wǎng)站超詳細教程
Hexo常見問題解決方案

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容