本文记录使用 Hexo + Butterfly 主题搭建个人博客的完整过程。

环境准备

安装 Node.js

1
2
3
# 检查是否已安装
node -v
npm -v

安装 Hexo

1
npm install -g hexo-cli

初始化博客

1
2
3
4
5
6
7
8
9
# 创建博客目录
hexo init my-blog
cd my-blog

# 安装依赖
npm install

# 启动本地服务器
hexo server

安装 Butterfly 主题

1
npm install hexo-theme-butterfly

修改配置

在 _config.yml 中设置主题：

1
theme: butterfly

创建主题配置文件

创建 _config.butterfly.yml 覆盖主题默认配置。

常用命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 新建文章
hexo new "文章标题"

# 清理缓存
hexo clean

# 生成静态文件
hexo generate

# 启动本地服务器
hexo server

# 部署
hexo deploy

文章 Front-matter

1
2
3
4
5
6
7
8
9
10
11
---
title: 文章标题
date: 2025-01-05
tags:
  - 标签1
  - 标签2
categories:
  - 分类名
cover: /images/cover.jpg
top: 10  # 置顶
---

总结

Hexo 是一个快速、简洁的博客框架，配合 Butterfly 主题可以快速搭建出美观的个人博客。