Github Pages:Page build failed 問題原因及解決【cnchar、vuepress】

記錄一個究極奇怪的問題,Github Pages:Page build failed

本人寫了一個漢字工具庫 cnchar,部署在Github Pages上面,之前一直是這麼用的,後來突然有一次push代碼之後給我報錯了,Github Pages:Page build failed

在這裏插入圖片描述
百度 谷歌搜索都找不出原因,點進官方help文檔也沒有查到任何有用信息

於是只有祭出調試終極法器:排除法

首先新建分支來進行排除實驗

回到一個比較早的commit,push上去,發現github pages是可以的,排除github的問題

這個問題大概是我使用vuepress之後出現的

然後刪除docs之後,push上去,發現可以成功

再用排除法一個個刪除docs文件,試試看到底是哪個文件引起的報錯,此處貼一個試錯記錄

在這裏插入圖片描述

最終,發現居然後docs下面的README.md文件引起的

再刪除README.md中的代碼排除,發現這段代碼引起的
在這裏插入圖片描述
這是vuepress模板生成的語法,刪除掉就成功了,但是刪除掉肯定是不行的,於是嘗試在前面加一個空行,發現居然也可以

在這裏插入圖片描述
在這裏插入圖片描述
很奇怪,但總是是問題解決了

後來我又新建了一個倉庫,只把 docs/README.md 文件目錄複製過去,發現不會引發build failed

猜測可能是vuepress和這種寫法導致github pages構建解析失敗吧!

具體原因也就不去深究了,問題解決了!

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