GitHub+Hexo 搭建个人网站の问题解决记录

前言

此篇文章仅用来记录本人作为一枚小白在搭建个人博客的过程中遇到的问题及解决方法，不能作为一篇完整的建站教程。文中的搭建步骤99%参考的是教程：https://zhuanlan.zhihu.com/p/26625249 （该教程中有些out of date的内容已记录在本文中——2019.5.29）

如果你也和我一样想从零开始搭建一个自己的个人Blog，遇到问题时欢迎来这里找找解决方案。

【预计持续更新...】

---

目录

前言

1 SSH key设置失败问题

2 安装Hexo

3 关联Hexo与GitHub

4 绑定个性化域名

5 更换Hexo主题

---

1 SSH key设置失败问题

问题：在安装Git步骤中，尝试“ 在Git Bash中检测GitHub公钥设置是否成功，输入 ssh git@github.com ”之后，bash中的输出与教程不符，未设置成功。

原因&解决方法：首次设置时，会弹出"Are you sure you want to continue connecting (yes/no)?"，需要手动输入“yes”才行。

 

在指定的文件夹内（GitHubBlog文件夹）运行cmd，输入npm安装Hexo的命令后，cmd中如下显示：

2 安装Hexo

2.1 安装Hexo步骤中，在我的电脑E盘某目录下新建了一个文件夹为GitHubBlog。进入该文件夹，执行“按住shift键，右击鼠标点击命令行”时，未找到“Open command window here”选项。

解决方法：直接在当前文件夹目录栏输入cmd，回车，打开的命令行即进入了当前目录，效果相同。

2.2 执行“hexo init blog”命令后，其实是在GitHubBlog文件夹内新建了一个名为blog的文件夹。接下来需要在命令行中输入"cd blog"以进入GitHubBlog的子文件夹：blog文件夹内，才能执行接下来的三个命令“hexo new test_my_site”,"hexo g"和“hexo s”。

3 关联Hexo与GitHub

3.1 在修改blog中的配置文件_config.yml（用NotePad++打开的）时，一开始按照教程中的写法，失败。经各种搜索尝试，repository一条要改成“git@github.com:xxxxx”的写法，而不能像教程中一样写"https://xxxxx”。如下所示。

4 绑定个性化域名

首先在阿里云网站购买一个域名，如：sh2xxx.top。下一步需要对该域名进行实名认证，是能为其添加解析的前提。

4.1 如何 “ping你的 http://xxxx.github.io 的ip地址”——在命令行直接输入"ping sh2xxx.github.io"。（此处我输入几次，每次得到的结果不太一样。）

4.2 一开始按照教程所示，输入了两条解析，然后在github仓库的Settings里也设置好了Custom domain为www.sh2xxx.top，但是失败。在浏览器输入sh2xxx.github.io可以跳转到sh2xxx.top的自定义域名，但是这个域名显示无法解析地址。经过一番尝试，最后的解析设置如下：（猜测，前三个地址是否填其中一个就可以呢？保险起见，还是都写上了）

过了一会儿之后，发现又可以正常访问自己的域名了。emmm....

5 更换Hexo主题——NexT

5.1 我是按照教程里的git命令去下载了nexT主题，前三次下载失败，第四次莫名成功了。下载之后发现教程里给的那个下载地址是旧的，新的nexT主题似乎应该去 https://github.com/theme-next下载。

5.2 

6 常用命令

• 修改一些文件后（如：增加文章、修改主题配置）先本地预览：在GitHubBlog/blog文件夹下打开cmd，输入“hexo s”。（是hexo server的缩写）。执行该命令后，在浏览器输入地址“http://localhost:4000/”（默认端口）即可本地预览修改后的效果。正式上传，要先输入命令“hexo g”，然后输入“hexo d”。