基于 Hexo + GitHub Pages 搭建个人博客（一）

前言：我的博客写作之路

15 年刚上大学，第一次接触公众号，就萌生了创建一个公众号写点东西，但最终不了了之。
很快到了 16 年，开始接触网上各大博客网站，接触最多的当属 CSDN，萌生了注册一个博客，写一点自己在学习上遇到的问题，分享一些自己的解决办法，但最终还是不了了之。
16 年暑假，自媒体横行在全国各地，自己眼里似乎看到很多机会有似乎异常模糊。一个偶然的机会让我意识到必须开始弄个博客写点东西了，当时的想法是，先注册个头条号，16年下半年开学再弄博客写东西，这种事情不着急，时间一天天过，但这两件事最终都没做，不了了之。
时间一分一秒地到了17年，上半年这种注册博客，写博客的心态依然萦绕耳边，但并没有什么实际行动。
终于到了17年6月份左右，去了一个地方回来后，我手忙脚乱，立刻在网上的平台注册了一个博客，而后开始写自己学习上的东西。而后有急忙地注册了一个微信公众号，第一次开始使用键盘记录自己的学生和生活，而我拖延了2年半的博客与写作之路，也就从此开始。
网上的某博客平台广告很多，开始时我无从适应，不知道如何排版，加之打字速度与龟速相差不大，夸张点说就是，写一篇几百字的文章要一两个小时，开不知道自己写了什么东西，但也第一次知道了写作的收获如此之大，具体可以说上个三天三夜，这里略。
慢慢地开始有了搭建一个属于自己的个人博客，于是急功近利，浅藏辄止各种编程语言，最终无功而返，一事无成。
带着那门基础不扎实的 Java 语言，开始学习框架，搭建博客，尽管各种异常报错，乱码问题，还有点想放弃，却又不甘，因此目前也还在学习。
慢慢开始了 WordPress ，cnblogs ，简书，掘金等五花八门的信息筛选之中，最终还是选择了搭建一个 Hexo + GitHub Pages 的博客框架。

基于 Hexo + GitHub Page 搭建个人博客

一、搭建前准备

1、安装 Git：Git 是目前世界上最先进的分布式版本控制系统，可以有效、高速的处理从很小到非常大的项目版本管理。

（1）下载 Git：官网下载地址（各大系统版本都有 Git，这里以 Windows 版本为例）

（2）双击下载的 Git 安装包开始安装

（3）一直点 Next，继续安装

（4）点击 Install ，完成安装

（5）打开 cmd 命令窗口，执行以下命令，结果显示 Git 版本，安装成功

git --version

（6）、推荐两个学习 Git 的网站：

官方文档：点击这里前往
廖雪峰网站教程：点击这里前往

2、安装 Node.js：是一个基于 Chrome V8 引擎的 JavaScript 运行环境，轻量高效，Node.js 的包管理器 npm 是全球最大的开源库生态系统。

（1）下载 Node.js：官网下载地址（各大系统版本都有，这里以 Windows 为例）

（2）双击下载的 Node.js 安装包开始安装

（3）一直点 Next ，选择安装路径，继续安装

（4）点击 Install ，完成安装

（5）打开 cmd 命令窗口，执行以下命令，显示 Node.js 版本，安装成功

node -v

二、搭建 Hexo 博客

1、安装 Hexo，在电脑中新建一个 compassblog 文件夹存放自己的博客，在文件夹内右键点击 Git Bash 进入命令窗口，执行以下代码：

npm install -g hexo-cli

结果如下图：

2、初始化 Hexo，得到 hexo 文件夹，用于存放 Hexo 博客所有的文件，包括下面会讲到的主题文件，Git Bash 窗口执行以下代码：（无特别提示，以下代码基本都在 Git Bash 命令窗口执行）

hexo init hexo

结果如下图：

3、配置 Hexo，进入 hexo 文件夹安装依赖，部署形成的文件，分别执行以下代码：

cd hexo

npm install

hexo generate

结果如下图：

4、启动服务器：执行以下代码，可以看到服务器端口号是 4000

hexo server

结果如下图：按 Ctrl + C 可以停止服务器

5、打开浏览器，地址栏输入http://localhost:4000/ ，结果如下图，可以看到，初始化的 Hexo 博客搭建成功，可以访问

三、将初始化的 Hexo 博客部署到 GitHub Pages

1、注册一个 Github 帐号，新建一个仓库，仓库名为：compassblog.github.io ，如下图所示：（由于我的仓库已经创建，所以会显示仓库已经存在，并且这个仓库的名称必须严格按照 username.github.io 的格式来命名）

2、进入已经建好的仓库，点击 settings ，找到 GitHub Pages 选项，点击 Choose a theme 选择一个主题，然后点击 select theme 选择主题，如下图所示：（到这一步其实已经可以在地址栏访问自己选择的主题了，选择主题这一步其实可以忽略，但我觉得 GitHub 提供的主题还是蛮酷的，所以就附上这一步吧）

3、配置 Git 个人信息：在 compassblog 目录打开一个 Git Bash 窗口，输入下面的命令

git config --global user.name " GitHub 用户名 "

git config --global user.email " GitHub 邮箱 "

如我的是如下图这样输入：

4、生成 SSH KEY，其实就是生成一个公钥和密钥，因为 GitHub 需要一个密钥才能与本地相连接。执行以下命令，并连续按 3 次回车生成密钥：

ssh-keygen -t rsa -C " 邮箱地址 "

我电脑是如下图这样：

5、SSH KEY 生成之后会默认保存在 C:/Users/电脑名用户名/.ssh 目录中，打开这个目录，打开 id_rsa.pub 文件，复制全部内容，即复制密钥。

6、打开 GitHub ，依次点击头像-->Settings-->SSH and GPG keys-->New SSH key，将复制的密钥粘贴到 key 输入框，最后点击 Add Key ，SSH KEY 配置成功，如下图所示：

7、修改 hexo 文件夹下的 _config.yml 全局配置文件，修改 deploy 属性代码，将本地 hexo 项目托管到 GitHub 上，如下图所示：

deploy:

  type: git		#部署的类型

  repository: git@github.com:compassblog/compassblog.github.io.git # 仓库地址

  branch: master		#分支名称

  message: hexo deploy	#提交信息

8、执行下面的命令，安装 hexo-deployer-git 插件，快速把代码托管到 GitHub 上

npm install hexo-deployer-git --sava

结果如图所示：

9、执行下面的代码命令，将 hexo 项目托管到 GitHub 上

hexo clean && hexo generate && hexo deploy

注：hexo generate 可缩写为 hexo g ， hexo deploy 可缩写为 hexo d

结果如图所示：

10、浏览器地址栏输入 https://username.github.io/ 访问，可以看到博客已经部署到 GitHub 上，正常访问，如下图所示：

最后写几句

我本来想一次把这个基于 Hexo + GitHub Pages 搭建个人博客流程发布在一篇文章上面发布出来的，但实在是太长了，很难一篇文章写完。关于博客如何更换主题，如何进行个性更换，具体的配置等等很多的配置，后面找时间再持续的发布出来，欢迎关注，Thanks 。

扫描二维码关注微信公众号，了解更多