手把手教你使用Hexo+GitHub搭建个人博客并发布文章（附常见问题解决方法）
简介
本教程使用GitHub自带的GitHub pages来生成静态个人博客，而Hexo可以更换各种好看的主题，而且都是免费的，花一点时间就可以打造出自己独有的个人博客。
Hexo这个有力的工具可以让我们专注于写出一篇博客而不需要关心如何编写html和CSS，再如何形成一个网站，它可以根据markdown文档和指定的主题直接生成一个静态网站，对于新手朋友或者不是专门搞前端开发的人们非常友好。
还有一个优点就是GitHub pages生成的网站很稳定，就算自己的本地站点被删除，也完全不影响已经发布到GitHub仓库的文章，依旧可以访问查看。
接下来我们就开始动手搭建吧！
部署环境
在最最开始，肯定要准备一个属于自己的GitHub账号。因篇幅有限，这里就不再赘述如何注册账号了，如果你还没有GitHub账号，可以自行搜索如何注册。不过记得要使用邮箱注册。
安装git和node.js
要使用GitHub和Hexo，首先我们需要在本地安装git和node.js，因为Hexo基于node.js，再生成一个ssh密钥用于连接GitHub仓库以及本地文件夹。
安装时可以直接一路点下一步，按默认设置安装即可。如果想搞清楚细节，可以看Git详细安装教程。
想要验证安装是否成功，可以win+r输入cmd进入终端，输入node -v、npm -v和git –version，如果出现版本号说明安装成功。在文件资源管理器中右键，出现Open Git Bash here和Open Git GUI here。
连接GitHub和本地
在文件资源管理器中右键 - Open Git Bash here，打开git终端，输入以下两条命令，设置用户名和邮箱：
git config –global user.name “GitHub用户名”
git config –global user.email “GitHub邮箱”
创建ssh密钥文件：
ssh-keygen -t rsa -C “GitHub邮箱”
一路回车即可。
最后返回密钥结果和图片说明创建完成。
Generating public/private rsa key pair.
Enter file in which to save the key (/c/Users/Jingrong/.ssh/id_rsa):
Created directory ‘/c/Users/Jingrong/.ssh’.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /c/Users/Jingrong/.ssh/id_rsa
Your public key has been saved in /c/Users/Jingrong/.ssh/id_rsa.pub
The key fingerprint is:
SHA256:xxxx
The key’s randomart image is:
+—[RSA 3072]—-+
| |
| . |
| + * .. + |
| . + = . o|
| . S . . .|
| . . . . |
| . = . …o |
| +.= o +.++o |
| |
+—-[SHA256]—–+
找到路径Your public key has been saved in /c/Users/Jingrong/.ssh/id_rsa.pub，用记事本打开。ctrl+a将所有内容复制到剪切板。
登录GitHub，点击右上角自己的头像 - Settings，找到SSH and GPG keys，点击add SSH key：
将剪贴板中复制的密钥粘贴过来：
检测是否连接成功：
ssh git@github.com
如果出现Hi xxx! You’ve successfully authenticated…的提示，就说明连接成功。
安装Hexo以及Fluid主题
使用 npm 安装 Hexo：
npm install -g hexo-cli
输入hexo -v即可查看是否安装成功。
新建一个hexo站点根目录，在站点右键 - Open Git Bash here，执行以下命令：
hexo init
npm install
执行完成之后，指定文件夹的目录如下：
├── _config.yml —> 网站配置信息
├── package.json —> 应用程序的信息
├── scaffolds —> 模板文件夹
├── source —> 放置资源文件。
├── ├── _drafts
├── └── _posts —> .md文件
└── themes
除 _posts 文件夹之外，开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹，而其他文件会被拷贝过去。来自Hexo官方文档
完成后再执行以下命令：
hexo g
hexo s
访问http://localhost:4000，即可浏览生成的hexo页面。
接下来就可以在Themes | Hexo里开始挑选一个喜欢的主题啦！
以fluid主题为例，先找到fluid官方文档和GitHub仓库。
Hexo 5.0.0 版本以上，推荐通过 npm 直接安装，进入博客目录执行命令：
npm install –save hexo-theme-fluid
然后在博客目录下创建 _config.fluid.yml，将主题的 _config.yml内容复制过去。
指定主题
如下修改 Hexo 博客目录中的 _config.yml：
theme: fluid # 指定主题
language: zh-CN # 指定语言，会影响主题显示的语言，按需修改
主题配置
关于主题配置的详细步骤可以查看fluid的主题使用文档。
创建「关于页」
首次使用主题的「关于页」需要手动创建：
hexo new page about
创建成功后修改 /source/about/index.md，添加 layout 属性。
修改后的文件示例如下：
1 | --- |
编写文章
使用hexo的好处就在于不需要自己手写html，而只需要写md文档。
在resource/_post文件夹中新建md文档。
md文档的开头需要添加以下内容：
1 | --- |
写好之后输入命令
hexo g #将md编译成html保存到public文件夹中
hexo s #开启本地服务器查看网站
即可看到自己新添加的文章。
发布到GitHub Pages
创建GitHub仓库
点击右上角加号，选择new repository。
仓库名称按照用户名.http://github.io的格式填写。选择public，勾选add a README file。
最后点击创建仓库即可。
配置_config.yml文档
打开hexo站点的根目录，找到_config.yml文件，使用记事本打开。文档的最后将
1 | # Deployment |
修改为
1 | # Deployment |
保存。
到这里就可以进入git终端，输入命令hexo d将public文件夹提交到仓库中。不一会就能看见仓库中出现了一个新的main分支，里面有上传的public文件夹的内容。
生成GitHub Pages
进入刚刚生成的仓库。
source选择Deploye from a branch，Branch选择main分支，选择好之后点save保存设置。稍等一分钟，就可以看到”Your site is alive at xxxx”的提示，点击visit就可以在自己的网站上看到刚刚配置好的博客了。
附：
hexo常用命令如下：
npm install hexo -g #安装Hexo
npm update hexo -g #升级
hexo init #初始化博客
hexo n “我的博客” == hexo new “我的博客” #新建文章
hexo g == hexo generate #生成
hexo s == hexo server #启动服务预览
hexo d == hexo deploy #部署
hexo server #Hexo会监视文件变动并自动更新，无须重启服务器
hexo server -s #静态模式
hexo server -p 5000 #更改端口
hexo server -i 192.168.1.1 #自定义 IP
hexo clean #清除缓存，若是网页正常情况下可以忽略这条命令
