使用Hexo+Github搭建个人博客

作为个人博客搭建后的第一篇文章，我会简单分享如何使用 Hexo+Github 来零成本搭建个人博客，以及如何使用主题来美化博客。

前置准备

首先，请确保已经安装了

  • nodejs
  • npm
  • git

我们可以通过运行命令提示符（cmd），输入

1
2
3
node -v
npm -v
git -v

来查看安装版本以确定成功安装前置。

在前置安装完成之后，在cmd中输入

1
npm install hexo-cli -g

来下载Hexo。

本地生成 Hexo 博客内容

在你想要进行存储内容的位置新建文件夹并命名为 Blog ，在文件夹内空白处右击，选择 在终端中打开，输入

1
hexo init

以安装Hexo

如果此处显示 Command not found 或 无法将“hexo”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请使用 npx hexo init，后续不在重复。

完成后分别输入

1
2
hexo g（等待hexo生成网站静态文件）
hexo s（启动本地服务器来预览主题）

完成后在浏览器输入 http://localhost:4000 就可以看到默认网站了！
确认无误后可以使用 Ctrl+C 来关闭本地预览。

此时网站只是在本地服务器，我们接下来还需要借助 Github 仓库来让其他人可以访问我们的博客。

创建 Github 仓库

完成上述步骤，我们接着来创建用于存储静态页面的仓库。

首先，注册/登陆 Github

点击 Creat A New Repository，进入新建仓库的界面。

仓库名填为

1
username.github.io   (unsername就是你注册时填写的用户名，很重要，不能写错！)

选择 Public 以及 Add A README file
到下面点击 Creat 完成仓库创建

生成 SSh Keys

在Blog文件夹下，空白处右键点击 Git Bash Here，在Git Bash页面输入

1
ssh-keygen -t rsa -C "邮箱地址"  （邮箱地址请自行填入）

按 4 下回车
接着，在文件资源管理器中，进入C:\Users\用户名，进入.ssh文件，使用记事本打开 id_rsa.pub ，全选复制所有内容。

打开 Github ，进入用户设置，找到 SSh Keys

新建 SSh Keys，名称随意填写，将复制的代码全部粘贴到 Key 中，点击创建。

让我们测试一下是否成功：

在 Git Bash 中输入

Bash
1
ssh -T git@github.com

如果成功，会显示 

1
Hi xxx! You've successfully authenticated, but GitHub does not provide shell access.

上线博客

在 Github 之前创建的仓库，点击右上方 Code ，复制 Https 连接。

在之前创建的 Blog 文件夹中，使用合适的文本编辑器（vscode > 记事本 > word）打开 _config.yml

在最底部的 deploy 后面的部分全部删除，复制粘贴如下部分

1
2
3
type: git
repository: （此处粘贴上面复制的 Https 连接）
branch: main

！！！注意格式！！！
每行最前面有两个空格，每个冒号后有一个空格

确认无误后，保存并退出。

安装自动部署发布工具

回到 Blog 文件夹， 右键在终端中打开，输入

1
npm install hexo-deployer-git --save

完成后继续输入

1
2
3
4
hexo cl （清除本地缓存，推荐每次生成前运行一下）
hexo g
hexo s （本地预览一下，确认无误后 Ctrl+C 关闭）
hexo d （上传博客）

第一次使用 git 会需要进行配置

1
2
git config --global user.email "邮箱"
git config --global user.name "用户名"

完成后再运行

1
hexo d

在跳出的窗口中登陆 Github

如此这般，我们就把本地静态博客上传到 Github 仓库了！
稍等片刻，进入 Username.github.io 就可以看到我们的博客了

Hexo基本操作

1
2
3
4
5
hexo cl （清除本地缓存）
hexo g （生成静态博客页面）
hexo s （本地服务器预览）
hexo d （上传到 Github 仓库）
hexo new 文章标题 （创建博客文章）

最后一条命令会在Blog/source/_posts创建一个 文章标题.md 文件，使用 markdown 语法来完成写作。

主题美化

本站使用主题为Anzhiyu，此外还推荐Hexo-Theme-Butterfly，Hexo 有大量社区资源，可以自行搜寻喜欢的主题。