Hexo+Github博客搭建

一、准备

GitHub账号

GitHub官网使用邮箱进行注册（用户名建议不要太随意，后面会用到）。注册成功后顺便把用于保存我们网页Repositories(仓库)创建了:

点左上角那个绿色的New，首先设置Repository name，注意格式为你的用户名.github.io（成功发布后可以再在setting中绑定到自己的域名）下方默认是Private，这里选择Public，并勾选下方的Add a README file，下面这样就算是搞定了。

安装Node.js（提供JavaScript运行环境）

Node官网,下载左边的即可，一路Next安装即可。

安装Git(hexo部署到GitHub时要用。)

进入Git官网后在Downloads方框中选择自己的系统，选择自己电脑操作位数的Installer下载之后打开也是一路Next即可（此处需注意一下安装路径，待会要用）。

安装Hexo

我们采用Hexo来创建我们的博客网站，Hexo 是一个基于NodeJS的静态博客网站生成器，使用Hexo不需开发，只要进行一些必要的配置即可生成性化的博客网站，非常方便。点击进入 官网。

安装 Hexo:

WIn+R 输入cmd打开命令行，选择一个安装位置，比如我安装在F盘创建的Blog文件夹下，

1
2

F:     
cd Blog

然后使用下面的指令进行安装（可以在不同文件夹下安装）

1

npm install hexo-cli -g

在文件中创建一个项目 hexo-blog 并初始化

1
2
3

hexo init hexo-blog
cd hexo-blog
npm install

本地启动

1
2

hexo g
hexo s

接着浏览器访问 http://localhost:4000即可进入Hexo默认主题。

二、选择和更换主题

进入Hexo官网点击上方主题进行选择

*希望你不会选上头，哈哈哈。下面是Butterfly主题以及当前主题的下载链接，国内优先使用Gitee。

1
2

Butterfly :https://gitee.com/immyw/hexo-theme-butterfly.git
LiveMyLife:https://gitee.com/V_Vincen/hexo-theme-livemylife.git

安装

以Butterfly为例，打开cmd窗口cd定位到刚才hexo-blog下，然后执行

1
2
3

git clone https://gitee.com/immyw/hexo-theme-butterfly.git
npm install hexo-renderer-pug hexo-renderer-stylus --save
npm install

1.下载完成之后hexo-blog下就有一个叫做hexo-theme-butterfly的文件，将其拖入theme文件当中并将其文件名改为butterfly之后返回上一级文件夹，双击打开_config.yml文件(推荐VScode)。将theme后面的内容改为butterfly，注意引号后面有一个空格。

2.后续配置：进入自己的Github仓库页面，点击绿色的Code获取仓库链接

然后点击上边栏的Settings，点击Pages将Branch改为main

*为了方便后续上传到Github，在下方type处添加git，添加repo: 你的仓库链接，添加branch: main

*此时一并将url处同样改为仓库链接

运行

方法同上，打开cmd窗口，输入

hexo g
hexo s

然后访问 http://localhost:4000即可预览主题。

配置主题

请参考主题Butterfly的给出的指南，建议先对主题进行一些自定义修改后再提交到Github。

三、发布到GitHub Pages

使用Git配置SSH(Secure Shell)

*此处建议关闭代理服务之后再进行操作，不然会生成代理的SSH key，可能会影响上传

1. 找到刚才Git的安装路径，双击打开文件中的git-bash.exe输入下面的代码

1
2

git config --global user.name "Your Username" #要输入你的用户名(Github)
git config --global user.email "Your Email Address" #要输入你的邮箱地址(Github)

此时弹出登录框则直接进行登录,继续输入

1

ssh-keygen -t rsa -C "Github的注册邮箱"

生成之后前往C/用户/（你电脑的用户名）/.shh用记事本打开文件id_rsa.pub然后复制里面的所有内容。

2. 前往自己的Github主页，点击自己右上角的头像，点击settings,选择左边栏中的SSH and GPG keys,点击New SSh key进行填写：

1
2
3
4

Title:最好就取你电脑的设备名
Key type:
Authentication Key
Key:粘贴刚才复制的key

然后点击Add SSH key即可。

进行发布

同样打开cmd窗口，先配置git，输入

npm install hexo-depoloyer-git --save

然后生成并提交到Github

hexo g
hexo d

等待提交完成即可，回到Github仓库，刷新页面，之后访问网页地址查看是否成功

提交失败怎么办

首先进入博客文件，删除第一个文件.deploy_git,进入_config.yml,将上面步骤中两个https类型的仓库链接替换成SSH链接（获取方式相同）

之后打开cmd窗口，输入

hexo clean
hexo g
hexo d

四、推荐的MarkDown编辑器

首推开源的免费编辑器[Marktext](Release 0.17.1 · marktext/marktext · GitHub)，其次VScode也不错，哈哈哈。

五、将自己的域名解析到Github Pages

域名购买

当然得拥有一个域名，各大域名购买网站新用户首年还是挺便宜的。

*这里小小吐槽一下域名备案，真的很慢有木有，另外，个人域名不用之后记得注销实名。

域名解析

此处以腾讯云为例，在控制台中选择 DNS 解析 DNSPod选择自己的域名，然后点击快速添加解析，选择域名映射，下方输入自己的Page链接。

同样是在Settings的Pages页面中，在Custom domain中添加自己的域名并Save即可，解析完成后就可以用自己的域名进行访问了。

六、其他

以上是基于Windows的博客搭建指南，关于其他平台的搭建方法同样有很多值得参考和学习的地方。最后，希望本文能给你带来一点灵感和启发，just do it！

• ← Previous Post
• Next Post →