GitHub+Hexo搭建博客笔记

写在前面

一直想搭建一个个人博客主要是为了学习吧，我可以不写博客但是我得会搭建博客，会搭博客了我写不写是我的事，哈哈。。。

这是我的博客主页：https://mxy493.github.io/

采用GitHub+Hexo搭建博客的原因很简单，百度的，很多大佬推荐，要么就是WordPress，大概WordPress要付费的吧，不太清楚，总之GitHub+Hexo的方案目前一分钱没花，应该也是不需要花钱的，都是开源项目。

基本上都是参照网上的教程一步一步傻瓜式操作来的，可以说不需要什么专业知识，顺手写下这篇文章做测试吧。

Hexo介绍

Hexo官网有比较清楚的介绍，最好看看官网的文档，写的可以说是很详细很清晰了，可以先不懂，看完基本上就知道是怎么回事了，然后再来一步步操作。

正文

环境：Windows系统（我的是Windows 10专业版）

需要安装的软件：Git（不是GitHub），Node.js，Hexo（npm安装）

Git安装

下载并安装Git（安装不需要设置什么，默认就可以）

Git主要用于版本控制，很多操作都需要在Git Bash上进行，Git不懂可以自己学习一下，主要学学命令就行吧，网上很多教程。

Node.js安装

关于Node.js的一些介绍可以稍微看一下这篇文章–NodeJS简介，在本教程中NodeJS主要用于管理下载第三方包，例如hexo，而这些工作都是npm在负责的。

1.下载并安装Node.js

官网首页就有醒目的下载按钮，下载好后自选位置（尽量自己记着安装在哪儿）安装就行。

安装后输入Win+R输入cmd打开控制台输入以下代码：

node -v
npm -v

如果安装没有问题的话，会返回安装的版本号。

Hexo安装

为了避免出现错误后面的操作都在Git Bash进行。

首先新建一个存放Hexo文件的目录，自己找个位置就行，然后cd到该目录下，或者直接在该目录下鼠标右键点Git Bash Here就可以，开始安装

$ cd D:/mxy/Documents/Hexo #换成自己新建的的目录，斜杠不能反了，是'/'，'\'这样不行
$ npm install hexo-cli -g #安装hexo脚手架，没啥说的，官网给的安装命令
$ hexo init #Hexo自动在当前文件夹下下载搭建网站所需的所有文件
$ npm install #安装依赖包
$ hexo clean #清理缓存
$ hexo g #完整命令为hexo generate，生成静态文件
$ hexo s #完整命令为hexo server，启动服务器，用来本地预览

用浏览器访问 http://localhost:4000/ ，人生第一个博客就生成好了，巨简单，这是Hexo自动生成的博客，现在是本地浏览的，并没有发布到网上，使用了默认主题landscape，可以根据个人喜好更换主题，官网提供了很多可以使用的主题。

通过Github部署到网上

本地博客搭建好了接下来是要把它部署到网上，通过GitHub部署，也可以使用Coding，都差不多。

没有GitHub账号的话现在就需要注册一个了，名字别太花哨吧，记着自己注册用的邮箱账号。

Github Page：

浏览器打开GitHub主页，右上角“+”新建仓库New repository，

Repository name：mxy493.github.io 填入自己的仓库名称，自己用户名.github.io，最后自己的博客地址就是：https://自己的用户名.github.io/

配置SSH

Git Bash中输入命令：邮件地址为注册GitHub时的邮箱

$ ssh-keygen -t rsa -C "你的邮件地址"

回车回车回车，会提示输入密码，输入即可（输入密码是看不到的），也可以不用输入，然后会确认输入一次，就可以在刚刚的路径看到生成了两个文件，一个是id_rsa，另一个是id_rsa.pub，用VS code或者别的软件打开id_rsa.pub然后选中里面的全部内容，复制下来。

打开GitHub，右上角点击自己的头像，选择settings，左侧选择SSH and GPG keys，然后New SSH key，Title随意把复制的内容粘贴到下面的Key的框里面，最后点击Add SSH key完事。

发布

打开D:\mxy\Documents\Hexo\mxy，用VS code（或者别的可以编辑的软件都可以）打开_config.yml文件，文件最后可以看到

deploy:
  type:

修改（注意要换上自己的链接）

deploy:
  type: git
  repository: git@github.com:mxy493/mxy493.github.io.git  #这里换成自己的地址
  branch: master

不清楚自己的地址可以到GitHub上面看，右上角头像->Your Rrepositories，找到自己建的代码仓库打开

修改完成保存！

继续在Git Bash中输入以下命令：

$ hexo d #完整命令为hexo deploy，将本地文件发布到page服务平台上

如果遇到异常：

$ hexo clean && hexo g
$ hexo d

如果出现以下异常

ERROR Deployer not found: git

尝试输入以下命令，然后重新执行刚刚的两条命令

$ npm install hexo-deployer-git --save

这时候如果弹出一个对话框，输入在GitHub上面的用户名和密码即可

现在，博客就已经发布到网上了，可以通过地址https://自己的用户名.github.io/访问