Mac上搭建基于GitHub的Hexo博客

2017农历的最后几天，项目都完成得差不多了。想着建立一个自己的博客，花了两天时间，在网上搜索各种资料，总算是把个人博客建起来了。过程就是不断试错，是在进行不下去了，就推翻重来。本人是一枚iOS coder，工作机是一台Mac，所以就讲讲在macOS系统上如何基于Hexo+Github创建个人博客。文章开始前，需要提醒一下，文中出现的$符号，在终端中都是不需要输入或粘贴的。

环境配置

Node.js

用来生成静态页面。可直接在Node.js官网，下载镜像安装。

Git

用来提交本地的Hexo内容到Github上。
电脑上如果已经装了Xcode，可不比进行本步骤，因为Xcode自带git。
如果没有Xcode，可以使用 Homebrew, MacPorts ：brew install git;或下载 安装程序 安装
如果不是iOS开发者，其实真的没必要为了建站下一个好几G的Xcode

安装Hexo

所有必备的应用程序安装完成后，即可使用 npm 安装 Hexo。

$ npm install -g hexo-cli

这里如果报错，可以尝试sudo命令。输入管理员密码（Mac登录密码）即开始安装。

$ sudo npm install -g hexo-cli

初始化

终端cd到一个你选定的目录（Mac支持直接将文件或文件夹拖入终端，直接显示路径），然后执行hexo init命令

$ hexo init blogName

这里需要提一下，如果需要把博客的根目录文件夹建在桌面上：cd到桌面，然后执行hexo init blogName命令即可。系统会创建blogName这个目录在桌面上。
下一步，cd到blogName，执行安装命令

$ npm install

安装完毕后，指定文件夹的目录如下

.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

此时，可开启hexo服务器

$ hexo server
简写：
$ hexo s

服务器成功开启。系统会提示

INFO  Start processing
INFO  Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.

此时，在可以在浏览器中输入http://localhost:4000/ 或 127.0.0.1:4000 ，如果出现了下图页面，就说明已获得“阶段性”的成功。

关联Github

新建仓库

在自己的GitHub账户上创建一个新的仓库（repository）
命名规则为：你的用户名.github.io，如a334713698.github.io

配置文件

在blogName文件中，找到名为_config.yml的文件，使用任意文本编辑器打开此文件。
找到如下代码：

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type:

可通过键盘command+F，调起编辑器的搜索功能，查找“deploy”字段
并将内容填充为：

deploy:
  type: git
  repository: https://github.com/a334713698/a334713698.github.io.git

注意：repository:后填写的应该是自己的创建的仓库地址。

生成静态页面

此时应保证自己在blogName根目录下。如果不在指定目录，在终端上输入cd ，再直接将指定文件夹拖进终端，即可获取文件夹路径，按下回车，进入指定目录下。
接着执行generate命令：

$ hexo generate
简写：
$ hexo g

若出现如下报错：
ERROR Local hexo not found in ~/blog
ERROR Try runing: 'npm install hexo --save'

则执行命令：
$ npm install hexo --save

若无报错，自行忽略此步骤。

部署网页到git上

执行部署的命令

$ hexo deploy
简写：
$ hexo d

若执行命令hexo deploy仍然报错：
无法连接git或找不到git

则执行命令：
$ npm install hexo-deployer-git --save  

然后再次执行
$ hexo generate //生成静态页面
$ hexo deploy   //部署到git

tip：静态页面生成和部署两个步骤可以合并写成：
$ hexo g -d

若未关联过Github，则执行hexo deploy命令时终端会提示你输入Github的用户名和密码，正确填写GitHub的账号密码即可。
hexo deploy部署成功后，浏览器中打开网址 http://a334713698.github.io （将a334713698换成自己的用户名）也能看到博客的主页。

添加ssh key到Github

检查SSH keys是否存在Github

执行如下命令，检查SSH keys是否存在。

$ ls -al ~/.ssh

如果有文件id_rsa.pub 或 id_dsa.pub，则直接进入将SSH key添加到Github中的步骤，否则进入下一步生成SSH key。

生成新的ssh key

执行如下命令生成public/private rsa key pair，注意将your_email@example.com换成你自己注册Github的邮箱地址。

$ ssh-keygen -t rsa -C "your_email@example.com"

默认会在相应路径下（~/.ssh/id_rsa.pub）生成id_rsa和id_rsa.pub两个文件。

将ssh key添加到Github中

Finder（访达）前往~/.ssh/id_rsa.pub打开id_rsa.pub文件，里面的信息即为SSH key，将这些信息复制到Github的Add SSH key页面即可。

进入Github –> Settings –> SSH and GPG keys –> add SSH key

Title任意填（也可不填，我就没填），粘贴内容要从头部的ssh-rsa开始粘，将复制的内容粘贴到Key里，点击下方Add key完成设置。

结尾

到这里，建站工作基本搞定。接下去，就可以发布文章，更换主题了。
本文大部分内容都参考于与佳期的个人博客 的 《Mac上搭建基于GitHub的Hexo博客
述》一文。文中还涉及文章发布，域名绑定，主题更换等内容，都非常有帮助。

打赏