前言

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

本教程将带你从零开始搭建一个 Hexo 博客。

准备工作

1. 安装 Node.js

Hexo 基于 Node.js，所以首先需要安装 Node.js。

Windows 用户：

  • 访问 Node.js 官网
  • 下载 LTS 版本（长期支持版）
  • 运行安装程序，一路”下一步”即可

验证安装：
打开命令行（CMD 或 PowerShell），输入：

1
2
node -v
npm -v

如果显示版本号，说明安装成功。

2. 安装 Git

Hexo 需要使用 Git 进行版本控制和部署。

Windows 用户：

  • 访问 Git 官网
  • 下载 Windows 版本
  • 运行安装程序，使用默认配置即可

验证安装：

1
git --version

安装 Hexo

1. 全局安装 Hexo

在命令行中执行：

1
npm install -g hexo-cli

2. 初始化博客

选择一个目录，执行以下命令：

1
2
3
hexo init myblog
cd myblog
npm install

这会在当前目录下创建一个 myblog 文件夹，并安装必要的依赖。

3. 启动本地服务器

1
2
3
hexo server
# 或者简写
hexo s

打开浏览器访问 http://localhost:4000，你将看到 Hexo 的默认欢迎页面。

目录结构

初始化后的博客目录结构如下：

1
2
3
4
5
6
7
8
9
myblog/
├── _config.yml       # 网站配置文件
├── package.json      # 应用程序信息
├── scaffolds/        # 模版文件夹
├── source/           # 资源文件夹
│   ├── _drafts/      # 草稿
│   └── _posts/       # 文章
├── themes/           # 主题文件夹
└── public/           # 生成的静态文件（执行 hexo generate 后生成）

创建第一篇文章

1. 创建文章

1
hexo new "我的第一篇文章"

这会在 source/_posts/ 目录下创建一个 Markdown 文件。

2. 编辑文章

打开刚才创建的文件，编辑内容：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
---
title: 我的第一篇文章
date: 2026-01-02 21:00:00
tags:
  - 测试
categories:
  - 随笔
---

## 欢迎来到我的博客

这是我的第一篇文章，使用 Hexo 搭建的。

### Markdown 语法

Hexo 支持 Markdown 语法，你可以轻松编写格式化的内容。

3. 查看效果

保存文件后，刷新浏览器，你将看到新文章出现在首页。

常用命令

创建文章

1
hexo new "文章标题"

启动服务器

1
hexo server

生成静态文件

1
2
3
hexo generate
# 或者简写
hexo g

部署

1
2
3
hexo deploy
# 或者简写
hexo d

清理缓存

1
hexo clean

组合命令（生成并部署）

1
hexo clean && hexo g && hexo d

配置文件

打开 _config.yml 文件，可以修改博客的基本配置：

1
2
3
4
5
6
7
8
9
10
11
12
# 网站
title: 我的博客
subtitle: 记录生活，分享知识
description: 基于 Hexo 的个人博客
keywords: Hexo, 博客, 技术
author: 你的名字
language: zh-CN
timezone: Asia/Shanghai

# URL
url: https://yourname.github.io
permalink: :year/:month/:day/:title/

配置 GitHub Pages

1. 创建 GitHub 仓库

  1. 登录 GitHub
  2. 创建一个新仓库，命名为 yourname.github.io（替换 yourname 为你的用户名）
  3. 设置仓库为 Public

2. 安装部署插件

1
npm install hexo-deployer-git --save

3. 修改配置文件

在 _config.yml 末尾添加：

1
2
3
4
deploy:
  type: git
  repository: https://github.com/yourname/yourname.github.io.git
  branch: main

4. 部署到 GitHub

1
hexo clean && hexo g && hexo d

首次部署时，可能需要输入 GitHub 账号和密码。

5. 访问博客

等待几分钟后，访问 https://yourname.github.io 即可看到你的博客！

常见问题

Q: 如何更换端口？

A: 使用 hexo server -p 4001 可以指定端口。

Q: 如何新建页面？

A: 使用 hexo new page "about" 可以创建新页面。

Q: 如何安装主题？

A: 下载主题到 themes 目录，然后在 _config.yml 中设置 theme: 主题名称。

Q: 如何删除文章？

A: 直接删除 source/_posts/ 下的对应文件，然后重新生成。

下一步

恭喜你，已经成功搭建了 Hexo 博客！

接下来的教程将介绍：

继续学习，打造一个更漂亮的博客吧！