学习笔记：搭建个人博客的基本操作（GitHub + Hexo）

---

本文记录了一些搭建个人博客的基本操作。是在win10系统上进行的操作，虚拟机上装过ubuntu18，试过，太卡。还是用本机吧。

---

---

前言

Hexo是一款基于Node.js的静态博客框架，算是目前主流的框架之一（主要是可以托管到GitHub上，不用买服务器，担心流量等问题）。

另外作者是台湾人，对中文使用者也很友好。

操作内容：下载node.js，下载npm，更换镜像源，使用cnpm（淘宝），下载hexo。部署项目到github上。

---

1.下载安装node.js，配置环境变量

Node.js官网：https://nodejs.org/zh-cn/

安装方面没有啥好说的，一直点击“next”就行。

下载 node.js 之后，配置相关的环境变量。

2. npm cnpm

npm简介：npm（Node Package Manager），是node包管理和分发工具。其实我们可以把NPM理解为前端的 Maven 。

通过npm可以很方便地下载js库，管理前端工程。现在的node.js已经集成了npm工具，在命令提示符输入 npm -v 可查看当前 npm 版本

node -v
npm -v

切换NPM镜像

# 在安装cnpm的时候指定镜像仓库
npm install -g cnpm --registry=https://registry.npm.taobao.org

查看cnpm的版本号

cnpm -v

查看安装完成后的路径

npm config ls

一般都是默认下载位置是AppData

npm修改全局下载和缓存路径

npm config set cache "D:\Program Files\npm-cache"
npm config set prefix "D:\Program Files\npm_global"

修改完成之后，再次 npm config ls 就会看到变化。而且.npmrc 文件也会有变化，这个文件在C盘的用户目录下。

比如 C:\Users\Administrator。

3.cnpm下载hexo

搞定了node，可以直接下载hexo。

npm install -g hexo-cli

# 查看 hexo 版本号
hexo -v

可以先创建一个文件夹，比如myblog，然后cd到这个文件夹下。（就是在该目录下打开cmd）

初始化一下hexo

hexo init myblog

启动本地博客服务

hexo s 

会出现本地博客服务地址：http://localhost:4000

可以在本目录下的 \source\_posts\找到文件并且修改

之后进行如下操作

hexo clean #清理
hexo generate #生成

4.GitHub相关操作

下载Git：https://git-scm.com/download

在GitHub上创建一个仓库，仓库名为：xxxx.github.io。

注意：必须创建一个和你用户名相同的仓库，后面加.github.io。
只有这样，在将来要部署到GitHub page的时候，才会被识别，也就是xxxx.github.io。
其中xxx就是你注册GitHub的用户名。

生成SSH添加到GitHub

以下操作在 git bash 中完成

git config --global user.name "yourname"
git config --global user.email "youremail"

此处的yourname输入你的GitHub用户名，youremail输入你GitHub的邮箱。

这样GitHub才能知道你是不是对应它的账户。

可以用以下两条指令，检测是否输入正确。

git config user.name
git config user.email

然后创建SSH,一路回车

ssh-keygen -t rsa -C "youremail"

在诸如C:\Users\Adminstier\.ssh下找到以下两文件

ssh，简单来讲，就是一个秘钥。

其中，id_rsa是你这台电脑的私人秘钥，不能给别人看的；id_rsa.pub是公共秘钥，可以随便给别人看。

把这个公钥放在GitHub上，这样当你链接GitHub自己的账户时，它就会根据公钥匹配你的私钥，当能够相互匹配时，才能够顺利的通过git上传你的文件到GitHub上。而后在GitHub的setting中，找到SSH keys的设置选项，点击New SSH key，把你的id_rsa.pub里面的信息复制进去。

在git bash中，输入如下指令，查看连接是否成功

ssh -T git@github.com

出现上述情况，就说明链接成功了。

5.将hexo部署到GitHub

打开站点配置文件 _config.yml，翻到最后，修改为你的GitHub账户

deploy:
  type: git
  repo: https://github.com/YourgithubName/YourgithubName.github.io.git
  branch: master

注意：要加空格！

这个时候需要先安装deploy-git ，也就是部署的命令,这样你才能用命令部署到GitHub。

npm install hexo-deployer-git --save

之后的操作是

hexo clean
hexo generate
hexo deploy

一般更改本地文件都建议做这些操作。

注意 deploy 时可能要你输入 username 和 password

这个需要一些时间，过一会儿就可以在http://yourname.github.io 这个网站看到自己的博客了。

6.换肤

换肤的话，点击这个网站找到自己想要的主题即可：https://hexo.io/themes/

一般都是在_config.yml文件中的theme更改信息的。

我目前使用的是这个butterfly主题：https://butterfly.js.org/posts/21cfbf15/

总结

以上就是hexo结合github搭建个人博客的最基础操作。

参考

CSDN：hexo史上最全搭建教程