记录一个究极奇怪的问题,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构建解析失败吧!
具体原因也就不去深究了,问题解决了!