
hexo博客搭建指北
注:教程以Windows系统为例
1. 安装Node.js
2. 安装git
一直点确定就行,全部按它默认勾的,若要细细配置可参照这篇文章
3. 测试一下,管理员运行cmd,依次输入
1 | node -v |
若正常显示版本号即可
4. 下载hexo
- 新建一个文件夹,用来存放blog
- 右键,选择Open git bash here
- 依次输入
1
2
3
4
5npm install hexo-cli -g
hexo init blog
cd blog
npm install
hexo server
5. 简单认识hexo
- 进入自动创建的blog文件夹
- _config.yml,在这个文件内修改博客基础设置
- blog\source_posts,在这个文件夹内修改博客文章
- themes,在这个文件夹内修改主题
- 在自动创建的blog文件夹内右键,选择Open git bash here
- 基础指令:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24# 开启服务
hexo s
# 新建文章
hexo new 文章名
# 新建草稿
hexo new draft 文章名
# 发布草稿成为文章
hexo publish 文章名
# 普通页面
hexo new page 页面名
# 清空缓存
hexo cl
# 生成静态页面
hexo g
# 然后访问localhost:4000
# 部署文章
hexo d
6. 搭建仓库
- 注册/登入Github(可能无法访问,建议使用watt tolkit)
- 点击Create a new repository进入新建仓库页面,仓库名输入:
1
你的GitHub用户名.github.io
- 勾选 Public
- 勾选 Add a README file
- 拉到下面点击create创建
7. 生成SSH Keys
- 进入任意文件夹,右键空白处然后点Open Git bash here,输入
1
ssh-keygen -t rsa -C "你的GitHub注册邮箱"
- 敲4次Enter
- 进入C:\Users\用户名,在里面进入 .ssh文件夹
- 打开里面的id_rsa.pub,全选复制里面的代码
- 打开github
- 进入用户设置,找到SSH keys
- 新建SSH keys,名称随意,在下面粘贴代码,然后创建
8. 测试是否成功
- 在git bash中输入回车,然后再输入yes
1
ssh -T git@github.com
9. 配置_config.yml
进入之前的Blog文件夹,打开 _config.yml
拉到最下面将deploy后面的全删掉,复制粘贴这段
1
2
3type: git
repository:
branch: main注意缩进格式:每行前面都有两个空格不要删,每个冒号后面都有个空格也不要删!
去github之前生成的仓库页面,点code,复制https链接,将其粘贴到repository:后面,然后保存退出
10. 安装自动部署发布工具
回到博客文件夹,一样git bash
输入:
1
npm install hexo-deployer-git --save
在Blog文件夹右键打开git bash,依次输入
1
2hexo g
hexo d如果是第一次使用git的话会需要配置
1
git config --global user.email
user.email即你注册GitHub的邮箱
1
git config --global user.name
user.name即你注册GitHub的名字
配置完后再输入
1
hexo d
,然后在跳出来的窗口内进行登录
接下来我们就成功把本地内容上传到github了
11.上传成功
上传成功以后,我们就算搭建好了!上自己的网址看看吧
网址是我们之前设的仓库名:你的GitHub用户名.github.io
- 标题: hexo博客搭建指北
- 作者: 文文文
- 创建于 : 2025-05-11 20:02:30
- 更新于 : 2025-07-10 18:54:03
- 链接: https://blog.realityme.top/2025/05/11/hexo博客搭建指北/
- 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。
评论