Hexo+Github搭建个人博客教程

一、下载nade.js（windows）

下载网址如下：<下载 | Node.js 中文网 (nodejs.cn)>

一般建议下载16.18.1，因为最新版可能后续会出现一些问题

这里不建议保存到主盘中，可以换一个盘进行存储

验证安装

• 在键盘按下【win+R】键，输入cmd，然后回车，打开命令行界面

• 进入命令提示符窗口，分别输入以下命令，显示版本号，则安装成功

node -v # 显示安装的nodejs版本
npm -v # 显示安装的npm版本

二、安装git

下载安装地址：https://git-scm.com/downloads](https://link.zhihu.com/?target=https%3A//git-scm.com/downloads)

此前作者已经安装过，这里不做详细说明

验证安装

• 在键盘按下【win+R】键，输入cmd，然后回车，打开命令行界面

• 进入命令提示符窗口，分别输入以下命令，显示版本号，则安装成功

• git --version

三、连接github

使用邮箱注册 GitHub 账户，选择免费账户（Free），并完成邮件验证。

右键 -> Git Bash Here，设置用户名和邮箱：

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

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

创建 SSH 密匙：

输入 ssh-keygen -t rsa -C "GitHub 邮箱"，然后一路回车。

添加密匙：

进入 [C:\Users\用户名.ssh] 目录（要勾选显示“隐藏的项目”），用记事本打开公钥 id_rsa.pub 文件并复制里面的内容。

登陆 GitHub ，进入 Settings 页面，选择左边栏的 SSH and GPG keys，点击 New SSH key。

Title 随便取个名字，粘贴复制的 id_rsa.pub 内容到 Key 中，点击 Add SSH key 完成添加。

验证连接：

打开 Git Bash，输入 ssh -T git@github.com 出现 “Are you sure……”，输入 yes 回车确认。

显示 “Hi xxx! You've successfully……” 即连接成功。

创建 Github Pages 仓库

GitHub 主页右上角加号 -> New repository：

• Repository name 中输入 用户名.github.io

• 勾选 “Initialize this repository with a README”

• Description 选填

填好后点击 Create repository 创建。

创建后默认自动启用 HTTPS，博客地址为：https://用户名.github.io

三、安装hexo

在本地电脑中创建文件夹用来存储博客内容（按照自己需求即可）

D:\blog

在powershell（按住shift+右键）中进入当前文件夹，输入代码安装hexo

初始化hexo

初始化并安装所需组件（在根目录blog处右键->git-bush-Here)输入以下代码：

hexo init # 初始化

npm install # 安装组件

输出结果如下所示：

完成后依次输入下面命令，启动本地服务器进行预览：

hexo g # 生成页面

hexo s # 启动预览

访问 http://localhost:4000，出现 Hexo 默认页面，本地博客安装成功！

Tips：如果出现页面加载不出来，可能是端口被占用了。Ctrl+C 关闭服务器，运行 hexo server -p 5000 更改端口号后重试。

Hexo 博客文件夹目录结构如下：

四、部署到Github

在VsCode（记事本或其它软件也可以）中打开blog文件夹，找到_config.yml文件，找到deploy，按照以下格式进行修改：

deploy:

type: git

repo: git@github.com:你的用户名/你的用户名.github.io.git

branch: master

最后执行以下命令：

hexo clean # 清除缓存

hexo g # 生成静态网页

hexo d # 部署到Github

顺利的话，在浏览器输入：

用户名.github.io

即可跳转到博客界面，如果没有出现，请稍等几分钟后刷新界面！

五、如何写新博客并推送到远程

通过上面的步骤后，你的博客应该就已经搭建成功，而且能通过 https://用户名.github.io 的方式进行访问了。接下来如果我们要发一篇新的博客内容，又应该怎么办呢？接下来就详细讲一下如何操作。

1. 首先进入博客所在文件夹，然后右键进入控制台，用如下命令进行创建新的文章；

hexo n "博客标题名"

2. 接着在 blog/source/_posts 目录下应该就会有创建好的以文章标题名命名的 Markdown 文件；

• 1、接着打开该文件，编写你自己想要的内容即可；

• 2、接着在控制台使用如下命令，将其推送到远程 GitHub 仓库，等过一会儿之后，访问即可看到刚才推送的新文章了！

hexo g

hexo d