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构建解析失败吧！

具体原因也就不去深究了，问题解决了！