使用 hexo 搭建 GitHub Page 博客后,网页显示 404 的问题解决

1. 问题描述

使用 hexo 搭建 GitHub Page 博客后,第一次正常,第二次上传后,博客网页显示 404 页面。

2. 问题原因

因为绑定了域名,所以在 github 仓库根目录下有一个 CNAME 的文件,文件中写有需要绑定的域名。而使用 hexo 远程部署时会删除这个文件。所以页面会报 404 错误。

3. 解决方法

只要在 github 仓库根目录下添加一个 CNAME 文件,且上传时不会被覆盖即可,方法如下:

3.1 在 hexo 指定文件夹下的 source 文件夹下添加 CNAME 文件,CNAME 文件中添加域名。

3.2 然后在 Terminal 执行

1
2
3
hexo clean
hexo g
hexo d

3.3 查看 github 仓库根目录有该 CNAME 且博客可以正常访问