Hexo+Github搭建个人博客教程

最新推荐文章于 2025-07-07 21:51:10 发布

Rockivy-

最新推荐文章于 2025-07-07 21:51:10 发布

阅读量3.9k

点赞数 62

CC 4.0 BY-SA版权

分类专栏：技术干货文章标签： github

本文链接：https://blog.csdn.net/PQ781826/article/details/139583110

hexo官网：https://hexo.io/zh-cn/

butterfly 主题设置：https://butterfly.js.org/

GitHub地址：https://github.com/jerryc127/hexo-theme-butterfly

基础命令

初始化博客命令：hexo init “文件名”
开启本地服务（本地运行）的命令：hexo s
生成页面（生成博客）： hexo g
创建文章（md形式）：hexo n “文章名字”
清理缓存：hexo clean
依赖安装：npm install
新建文章：hexo n “文章名”

发布顺序

先清理缓存：hexo clean
再重新生成博客页面：hexo g
预览：hexo serve
上传到GitHub创库：hexo d

Hexo+Github搭建个人博客

前言

完全免费的搭建个人博客，没有任何收费，零基础小白也能上手，不需要编程基础，跟着操作来即可。
首先要了解一下我们搭建博客要用到的框架。Hexo是高效的静态站点生成框架，它基于Node.js。通过Hexo，你可以直接使用Markdown语法来撰写博客。相信很多小伙伴写工程都写过README.md文件吧，对，就是这个格式的！写完后只需两三条命令即可将生成的网页上传到你的github上，然后别人就可以看到你的网页啦。是不是很简单？你无需关心网页源代码的具体细节，你只需要用心写好你的博客内容就行。

Hexo环境准备

【2021版本】保姆级Hexo+Github搭建个人博客步骤

单纯搭建发布视频讲解地址：https://www.bilibili.com/video/BV1mU4y1j72n?t=2.5&vd_source=71e92a1364cbcaf80125baa05f89bc60
详细视频讲解：https://www.bilibili.com/video/BV1oU4y1n7hn/?spm_id_from=pageDriver&vd_source=91c74d407fc476374430aea2a76f7aca

Node.js安装

https://www.cnblogs.com/liuqiyun/p/8133904.html

Git安装

安装步骤参考以下步骤
https://www.cnblogs.com/xueweisuoyong/p/11914045.html

Vscode安装

后面涉及到代码的修改，建议大家使用 Vscode 软件
安装链接：「VSCodeUserSetup-x64-1.65.0.exe」 https://pan.quark.cn/s/f64b7413660c 提取码：7eMQ
本文软件需要用到的操作说明：
打开终端，本文用到的命令都是在终端里面输入命令+回车的
ctrl + f 查找内容的快捷键，因为配置文件的代码太多了，需要用到这个快捷键，然后在搜索框输入要搜索的内容，就能实现快速查找

Typroa

用于写文章
Markdown介绍

Github

github访问加速

「fastgithub_win版-x64.zip」链接：https://pan.quark.cn/s/4c170f5763d2 提取码：sFNj

其余版本建议访问： https://github.com/dotnetcore/FastGithub

注册Github账号

接下来就去注册一个github账号，用来存放我们的网站，注册、使用教程 CSDN自己搜，这里就不提供了

搭建仓库

打开https://github.com/，新建一个项目

然后如下图所示，输入自己的项目名字，后面一定要加.github.io后缀，README初始化可选可不选。名称一定要和你的github名字完全一样，比如你github名字叫**abc**，那么仓库名字一定要是**abc.github.io**。最后选择Create 创建，项目就建成功了

7618709e-cbd7-42f7-864b-4ec485838378

Hexo搭建

一定要保证前面的步骤成功后，在执行该章节后面的步骤

安装Hexo

在你的电脑上任意位置，新建一个文件夹，用来存放自己的博客文件，比如我的博客存放位置D:\boke\blog目录下。
在该根目录下，鼠标右击，选择Git Bash Here，打开git的控制台窗口，输入npm i hexo-cli -g安装Hexo。会有几个报错，无视它就行。
安装完成后，验证是否安装成功，该窗口输入hexo -v验证是否安装成功。

生成ssh keys

在任意文件夹位置，鼠标右击，选择Git Bash Here，输入 ssh 检查有没有安装ssh
生成ssh命令：

ssh-keygen -t rsa -C "[email protected]"

总共需要敲四次回车。

aa2d2c59-b158-4725-9886-63483dbce617

找到 id_rsa.pub 文件，并打开复制里面所有的代码，大致路径： c盘----->用户------>管理员名称-------->.ssh文件夹下

或者

git bash中输入cat ~/.ssh/id_rsa.pub下命令，将输出的内容复制到框中，点击确定保存。
打开github，在头像下面点击settings，在新出的导航栏，找到 ssh，点击后，在新的页面点击 ssh keys 的新建钥匙，新建钥匙的 title（名称）随意起名，如：blog，将 id_rsa.pub 文件复制的公钥，粘贴到 key 里面，保存。

a1513cac-fa62-45dd-be61-190baa224a76