Github Pages:Page build failed 问题原因及解决【cnchar、vuepress】

记录一个究极奇怪的问题,Github Pages:Page build failed

本人写了一个汉字工具库 cnchar,部署在Github Pages上面,之前一直是这么用的,后来突然有一次push代码之后给我报错了,Github Pages:Page build failed

Github Pages:Page build failed 问题原因及解决【cnchar、vuepress】_第1张图片
百度 谷歌搜索都找不出原因,点进官方help文档也没有查到任何有用信息

于是只有祭出调试终极法器:排除法

首先新建分支来进行排除实验

回到一个比较早的commit,push上去,发现github pages是可以的,排除github的问题

这个问题大概是我使用vuepress之后出现的

然后删除docs之后,push上去,发现可以成功

再用排除法一个个删除docs文件,试试看到底是哪个文件引起的报错,此处贴一个试错记录

Github Pages:Page build failed 问题原因及解决【cnchar、vuepress】_第2张图片

最终,发现居然后docs下面的README.md文件引起的

再删除README.md中的代码排除,发现这段代码引起的
在这里插入图片描述
这是vuepress模板生成的语法,删除掉就成功了,但是删除掉肯定是不行的,于是尝试在前面加一个空行,发现居然也可以

在这里插入图片描述
在这里插入图片描述
很奇怪,但总是是问题解决了

后来我又新建了一个仓库,只把 docs/README.md 文件目录复制过去,发现不会引发build failed

猜测可能是vuepress和这种写法导致github pages构建解析失败吧!

具体原因也就不去深究了,问题解决了!

你可能感兴趣的:(vuepress,cnchar,github,pages,github)