用hexo+github搭建个人博客

发表于 2025-06-09 更新于 2025-06-16 分类于前端本文字数： 3.4k 阅读时长 ≈ 6 分钟

自己淋过雨就要为别人打伞，我也是才学会搭建个人博客之前看了很多视频，查了很多资料感觉总是差那么一点意思，在搭建的过程
中，自己也吃过很多亏，经过多次尝试，一路摸爬滚打过来才终于建起了自己的第一个个人博客；
以下的内容希望会给大家带来帮助：

第一步配置仓库 github

注册github账号

创建仓库 .github/io

首先在 GitHub 新建一个仓库（Repository），名称为 {username}.github.io，注意这个名比较特殊，必须要是 http://github.io 为后缀结尾的。比如 GitHub 用户名就叫 ColorMali，那我就新建一个 ColorMal.github.io，新建完成之后就可以进行后续操作了。

另外如果 GitHub 没有配置 SSH 连接的建议配置一下，这样后面在部署博客的时候会更方便(ssh配置我放到了后面)。

具体可参考上图进行配置

第二步环境准备

Git官方网站：Git下载

![屏幕截图 2025-06-09 144115](E:\ziliao\图片\素材\博客素材\屏幕截图 2025-06-09 144115.png)

选择这个

Node.js官方网站：Node.js下载

下面是关于环境配置的

配置完成后分别进行以下测试判断是否安装成功：

Nodejs –> 在Windows Powershell中输入命令：node -v ，出现版本号则证明安装成功

Git –> 在Windows Powershell中输入命令：git version ，出现版本号则证明安装成功

安装Hexo

打开git-bash输入安装命令：npm install hexo -g

运行结束后输入测试输入命令：hexo -v 验证是否安装成功

安装Hexo依赖

打开git-bash输入安装命令：npm install --save hexo-deployer-git

第四步git配置SSH key

为什么要配置SSH key？
目的：可以免密的将本地的源码和资源上传到github，无需要每次都输账号和密码。

命令生成

打开git-bash输入安装命令：ssh-keygen -t rsa -C

输入生成命令：ssh-keygen -t rsa -C "zhangyumao@petalmail.com"(最好写自己github绑定的那个邮箱) 后；连续按Enter三次即可；

检查本地是否有配置好SSH key 输入命令：cd ~/.ssh

命令安装

可以看到在用户文件夹下生成了一个ssh文件夹

进入到ssh文件夹，复制id_rsa.pub文件里全部内容

接着打开github个人主页点击<a href=”**https://github.com/“> Settings，打开个人设置，点击左侧的 SSH and GPG keys，点击新建New SSH key**，完成后点击 Add SSH key

点击 Add SSH key提交后测试是否成功，输入命令：ssh -T git@github.com 如图所示表示成功：

设置git用户名和邮箱

如果没有初始化过用户名和邮箱，需要用命令提示符设置一下用户名和邮箱。

1	git config --global user.name "ColorMao"` `git config --global user.email "zhangyumao@petalmail.com"

邮箱地址最好是真实有效的，而且最好是GitHub或者gitee的注册邮箱。

查看git用户名和密码

查看用户名：git config user.name

查看密码： git config user.password

查看邮箱：git config user.email

查看配置信息：git config --list

修改用户名和密码：git config --global user.name "xxxx(新的用户名)"

修改密码：git config --global user.password "xxxx(新的密码)"

修改邮箱：git config --global user.email "xxxx@xxx.com(新的邮箱)"

全局配置

配置完成后使用命令查看全局配置，输入命令： git config --list

第五步搭建个人博客

设置本地配置

创建一个本地保存博客的存放文件夹，例如：D:\你的邮箱名称\Blog Space

用git 命令进入文件夹：

输入 cd D:切换到目录所在磁盘下；
输入 cd ZhangYuMao 再次切换到下层目录所在位置；
当用cd 进入文件夹时,我们可以使用通配符：**\*** ；例如 cd B* 如果当前文件夹下只有一个B开头的文件夹,它就会进入到该文件夹；
继续向下切换可以输入下层文件夹名称；例如： cd 22Y08M03D*
进入到本地博客指定存放目录，输入命令：hexo init 开始初始化个人博客；

清除缓存

使用命令 hexo clean 可以清除缓存，清除缓存可以让新配置的信息立即生效。

然后执行命令：hexo generate 自动根据当前目录下文件,生成静态网页；

然后执行命令：hexo server 部署到本地服务器预览；注：Ctrl+C 可结束运行。

这时在浏览器输入： http://localhost:4000/ 就可以看到如下效果：

部署

现在来介绍常用的Hexo 命令

npm install hexo -g #安装Hexo
npm update hexo -g #升级
hexo init #初始化博客

命令简写
hexo n “我的博客” == hexo new “我的博客” #新建文章
hexo g == hexo generate #生成
hexo s == hexo server #启动服务预览
hexo d == hexo deploy #部署

hexo server #Hexo会监视文件变动并自动更新，无须重启服务器
hexo server -s #静态模式
hexo server -p 5000 #更改端口
hexo server -i 192.168.1.1 #自定义 IP
hexo clean #清除缓存，若是网页正常情况下可以忽略这条命令

刚刚的三个命令依次是新建一篇博客文章、生成网页、在本地预览的操作。

推送网站

上面只是在本地预览，接下来要做的就是就是推送网站，也就是发布网站，让我们的网站可以被更多的人访问。在设置之前，需要解释一个概念，在blog根目录里的_config.yml文件称为站点配置文件，如下图

进入根目录里的themes文件夹，里面也有个_config.yml文件，这个称为主题配置文件，如下图

下一步将我们的Hexo与GitHub关联起来，打开站点的配置文件_config.yml，翻到最后修改为：

deploy:
type: git
repo: 这里填入你之前在GitHub上创建仓库的完整路径，记得加上 .git
branch: main参考如下：

deploy:
   type: git
   repository: git@github.com:ColorMao/ColorMao.github.io.git          //你自己的项目路径
   branch: main

保存站点配置文件。

其实就是给hexo d 这个命令做相应的配置，让hexo知道你要把blog部署在哪个位置，很显然，我们部署在我们GitHub的仓库里。最后安装Git部署插件，输入命令：

1	npm install hexo-deployer-git --save

这时，我们分别输入三条命令：

1
2
3

hexo clean 
hexo g 
hexo d

其实第三条的 hexo d 就是部署网站命令，d是deploy的缩写。完成后，打开浏览器，在地址栏输入你的放置个人网站的仓库路径，即 “你的用户名”.github.io

创建加速站点

可跟这个视频做

个性化

如果想换皮肤可以访问Hexo的官网Hexo

修改博客的结构可以看这个视频

[馨客栈分享]使用Hexo博客搭建的个人博客，使用Next主题来进行优化改造_哔哩哔哩_bilibili