快速开始

环境要求

  • Node.js: 22.x（推荐，CI 环境使用此版本）
  • npm: 9.x+ 或 yarn
  • Git: 最新版本

注意: Node.js 24 与部分 Hexo 插件不兼容，请使用 Node.js 22。

安装依赖

1
2
3
4
5
6
7
8
# 克隆项目
git clone <repository-url>
cd HexoBlogDemo

# 安装依赖
npm install
# 或
yarn install

本地开发

1
2
3
4
# 启动本地服务器
npm run server

# 访问 http://localhost:4000

本地服务器支持热重载，修改文件后会自动刷新。

常用命令

命令说明
npm run server启动本地服务器
npm run build生成静态文件到 public/
npm run clean清理 public/ 和 db.json
npm run deploy部署到服务器

详细命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
# 生成静态文件
hexo generate
# 或简写
hexo g

# 清理数据库和静态文件
hexo clean

# 启动本地服务器
hexo server
# 或简写
hexo s

# 部署（需要配置 deployer）
hexo deploy
# 或简写
hexo d

# 新建文章
hexo new "文章标题"
# 或简写
hexo n "文章标题"

# 新建页面
hexo new page "页面名称"

项目结构说明

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
HexoBlogDemo/
├── _config.yml              # Hexo 主配置文件
├── _config.butterfly.yml    # Butterfly 主题配置文件
├── package.json             # 项目依赖和脚本
├── package-lock.json        # 依赖版本锁定
├── yarn.lock                # Yarn 依赖锁定
├── source/                  # 源文件目录
│   ├── _posts/              # 博客文章
│   ├── _data/               # 数据文件
│   ├── about/               # 关于页面
│   ├── categories/          # 分类页面
│   ├── tags/                # 标签页面
│   ├── css/                 # 样式文件
│   │   └── custom.css       # 自定义样式
│   └── img/                 # 图片资源
├── themes/                  # 主题目录
├── scaffolds/               # 文章模板
├── public/                  # 生成的静态文件（gitignored）
├── db.json                  # Hexo 数据库（gitignored）
├── node_modules/            # 依赖包（gitignored）
├── .github/                 # GitHub 配置
│   ├── workflows/           # GitHub Actions
│   └── dependabot.yml       # 依赖更新配置
└── docs/                    # 维护文档

文章模板

新建文章时会使用 scaffolds/post.md 模板：

1
2
3
4
5
6
7
8
9
---
title: {{ title }}
date: {{ date }}
abbrlink: 
categories: 
tags: 
---

正文内容...

下一步