手把手教你使用Hexo+GitHub搭建个人博客并发布文章（附常见问题解决方法）

ERRROR_

已于 2023-08-30 09:59:17 修改

阅读量4.6k

点赞数 6

文章标签： github git

于 2023-08-30 09:54:09 首次发布

本文链接：https://blog.csdn.net/qq_59016701/article/details/132576005

版权

本文手把手教你使用Hexo和GitHub搭建个人博客，包括安装git和node.js，连接GitHub，安装Hexo及Fluid主题，编写和发布文章，解决重装系统、图片显示等常见问题。

摘要由CSDN通过智能技术生成

简介

本教程使用GitHub自带的GitHub pages来生成静态个人博客，而Hexo可以更换各种好看的主题，而且都是免费的，花一点时间就可以打造出自己独有的个人博客。

Hexo这个有力的工具可以让我们专注于写出一篇博客而不需要关心如何编写html和CSS，再如何形成一个网站，它可以根据markdown文档和指定的主题直接生成一个静态网站，对于新手朋友或者不是专门搞前端开发的人们非常友好。

还有一个优点就是GitHub pages生成的网站很稳定，就算自己的本地站点被删除，也完全不影响已经发布到GitHub仓库的文章，依旧可以访问查看。

接下来我们就开始动手搭建吧！

部署环境

在最最开始，肯定要准备一个属于自己的GitHub账号。因篇幅有限，这里就不再赘述如何注册账号了，如果你还没有GitHub账号，可以自行搜索如何注册。不过记得要使用邮箱注册。

1. 安装git和node.js

要使用GitHub和Hexo，首先我们需要在本地安装git和node.js，因为Hexo基于node.js，再生成一个ssh密钥用于连接GitHub仓库以及本地文件夹。

git下载链接：Git - Downloading Package

node.js下载链接：Download | Node.js

安装时可以直接一路点下一步，按默认设置安装即可。如果想搞清楚细节，可以看Git详细安装教程。

想要验证安装是否成功，可以win+r输入cmd进入终端，输入node -v、npm -v和git --version，如果出现版本号说明安装成功。在文件资源管理器中右键，出现Open Git Bash here和Open Git GUI here。

2. 连接GitHub和本地

在文件资源管理器中右键 - Open Git Bash here，打开git终端，输入以下两条命令，设置用户名和邮箱：

$ git config --global user.name "GitHub用户名"   
$ git config --global user.email "GitHub邮箱"

创建ssh密钥文件：

$ ssh-keygen -t rsa -C "GitHub邮箱"

一路回车即可。

最后返回密钥结果和图片说明创建完成。

Generating public/private rsa key pair.
Enter file in which to save the key (/c/Users/Jingrong/.ssh/id_rsa):
Created directory '/c/Users/Jingrong/.ssh'.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /c/Users/Jingrong/.ssh/id_rsa
Your public key has been saved in /c/Users/Jingrong/.ssh/id_rsa.pub
The key fingerprint is:
SHA256:xxxx
The key's randomart image is:
+---[RSA 3072]----+
|                 |
|       .         |
|        + * .. + |
|       . + = .  o|
|      . S   . . .|
|     . .     . . |
|  .   = .  ...o  |
|   +.= o +.++o   |
|                 |
+----[SHA256]-----+