使用 Hexo+GitHub 搭建个人免费博客教程

1.安装git

1.访问git官方地址，下载对应的安装包，进行安装（简单的点击下一步）。

2.安装好之后，鼠标右键可以看到：Git Bash Here，点击后打开了。

3.输入：git –version

image-20260117144901894

出现这个说明git安装成功。

2.安装node.js

Node.js安装及环境配置超详细教程【Windows系统】_windows 安装nodejs-CSDN博客

此教程里最后的npm源改为：

1
npm config set registry https://registry.npmmirror.com/

3.安装Hexo

打开终端输入：

1
npm install -g hexo-cli

创建博客：

1
2
3
hexo init myblog
cd myblog
npm install

构建静态页面，启动本地预览：

1
2
hexo g
hexo s

然后访问：

1
http://localhost:4000

4.新建Markdown文章

运行：

1
hexo new post "我的第一篇博客"

然后会生成：

1
source/_posts/我的第一篇博客.md

你用 VSCode 打开它，里面类似这样：（也可以用Typora等md软件打开编辑）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
---
title: 我的第一篇博客
date: 2026-01-16
categories: 学习笔记
tags:
  - 深度学习
  - Python
---

这里开始写正文，支持 **Markdown**：

## 标题
- 列表
- **加粗**
- `代码块`

保存后：

1
hexo server

刷新网页就能看到你的文章

5.分类&标签管理

可以直接再文章里面指定：

1
2
3
4
categories: 分类name
tags:
  - 标签1
  - 标签2

Hexo会自动生成分类页面，标签页面，归档页面

6.部署到GitHub

1.创建GitHub仓库：

名字：你的用户名.github.io 因为这个仓库名称将作为你github博客的访问地址

image-20260117151642558

2.安装部署插件

1
npm install hexo-deployer-git --save

3.修改_config.yml

找到最后面deploy:’’替换为：

1
2
3
4
deploy:
  type: git
  repo: https://github.com/你的用户名/你的用户名.github.io.git
  branch: main

4.一键部署

1
2
3
hexo clean
hexo g
hexo deploy

然后访问：

https://你的用户名.github.io

7.修改配置

文件_config.yml中可以修改title，language等配置项

8.修改主题

可以去网上搜索自己喜欢的主题，我推荐Fluid主题，以这个主题为例：(详情可以浏览用户手册开始使用 | Hexo Fluid 用户手册)

1.安装主题

1
npm install --save hexo-theme-fluid

然后在博客目录下创建 _config.fluid.yml，将主题的然后在博客目录下创建 _config.fluid.yml，将主题的 _config.yml (opens new window)内容复制过去。内容复制过去。

2.指定主题

修改_config.yml文件：

1
2
3
theme: fluid  # 指定主题

language: zh-CN  # 指定语言，会影响主题显示的语言，按需修改

其它配置自己根据用户手册自行设置

教程
#blog
使用 Hexo+GitHub 搭建个人免费博客教程
http://example.com/2026/01/17/使用 Hexo+GitHub 搭建个人免费博客教程/
作者
Guo HL
发布于
2026年1月17日
许可协议