Hexo博客使用教程：从创建到部署的完整指南

作为一个静态博客框架，Hexo 提供了简单易用的博客解决方案。本教程将帮助你掌握 Hexo 的基本操作，包括创建新文章、编辑文章、添加图片、预览和部署等功能。即使你对命令行不熟悉，按照本教程也能轻松管理你的博客。

1. 博客基础知识

在开始前，了解几个基本概念：

  • Hexo：一个快速、简洁且高效的博客框架，使用 Markdown 编写文章
  • Markdown：一种轻量级标记语言，易于学习，可以快速排版
  • Front Matter：文章开头的 YAML 格式信息，定义标题、日期、标签等元数据
  • 部署（Deploy）：将本地博客发布到网络服务器的过程

2. 创建新博客文章

方法一：使用命令行创建（推荐）

  1. 打开终端（Terminal）
  2. 进入博客根目录（可以在终端中输入 cd 后空格，然后拖动博客文件夹到终端窗口）
  3. 输入以下命令：
1
hexo new post "文章标题"

例如，创建一篇名为”我的第一篇博客”的文章：

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

这个命令会在 source/_posts 目录下创建一个 我的第一篇博客.md 文件，同时创建同名文件夹用于存放图片等资源。

方法二：手动创建

如果你不想使用命令行，也可以手动创建：

  1. 打开 source/_posts 目录
  2. 创建一个新的 .md 文件，如 我的第一篇博客.md
  3. 在文件开头添加 Front Matter：
1
2
3
4
5
6
7
8
9
10
11
---
title: 我的第一篇博客
date: 2024-09-22 15:30:00
tags:
  - 标签1
  - 标签2
categories:
  - 分类名称
---

这里是文章内容...
  1. 同时在 source/_posts 目录下创建同名文件夹（如 我的第一篇博客），用于存放文章相关的图片等资源

3. 编辑博客内容

Markdown 基础语法

Hexo 使用 Markdown 语法编写文章，以下是一些基础语法：

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
26
# 一级标题
## 二级标题
### 三级标题

**粗体文字**
*斜体文字*

- 无序列表项
- 无序列表项

1. 有序列表项
2. 有序列表项

> 引用文字

[链接文字](https://example.com)

![图片描述](图片路径)

`行内代码`

​```python
# 代码块
def hello():
    print("Hello, World!")
​```

添加图片

由于已经开启了 post_asset_folder，每篇文章都会有自己的资源文件夹。添加图片的步骤：

  1. 将图片放入文章同名文件夹中，例如 source/_posts/我的第一篇博客/image.jpg
  2. 在文章中使用以下语法引用图片：
1
![图片描述](image.jpg)

如果想要更精确地控制图片，可以使用 Hexo 的标签插件：

1
{% asset_img image.jpg 图片描述 %}

4. 预览博客

编辑完文章后，你可能想要在发布前预览效果。执行以下步骤：

  1. 打开终端，进入博客根目录
  2. 执行以下命令：
1
hexo clean && hexo server

这个命令会清理之前生成的文件，并启动本地服务器。然后，你可以在浏览器中访问 http://localhost:4000 预览你的博客。

如果你不想使用命令行，可以创建一个批处理文件（Windows）或脚本（Mac/Linux）来简化这个过程：

Windows (preview.bat):

1
2
@echo off
hexo clean && hexo server

Mac/Linux (preview.sh):

1
2
#!/bin/bash
hexo clean && hexo server

然后双击这个文件即可启动预览。

5. 修改和重命名博客

修改博客内容

直接编辑 source/_posts 目录下的对应 .md 文件即可。

重命名博客

重命名博客涉及三个部分：文件名、文章标题和资源文件夹名称。

  1. 修改文章标题：
    打开文章的 .md 文件，修改 Front Matter 中的 title 字段：

    1
    2
    3
    ---
    title: 新的文章标题
    ---

  2. 重命名文件：
    直接将 source/_posts 目录下的 .md 文件重命名，如 旧标题.md → 新标题.md

  3. 重命名资源文件夹：
    同样将 source/_posts 目录下的同名文件夹重命名，如 旧标题 → 新标题

完成后，运行 hexo clean && hexo server 查看更改是否生效。

6. 部署博客

完成编辑后，就可以将博客部署到网络上。根据当前配置，你的博客会部署到 GitHub Pages。

方法一：使用命令行部署

  1. 打开终端，进入博客根目录
  2. 执行以下命令：
1
hexo clean && hexo deploy

这个命令会清理缓存，生成静态文件，并将它们部署到 GitHub Pages。

方法二：使用批处理文件/脚本部署

创建一个部署脚本，以后可以直接双击执行：

Windows (deploy.bat):

1
2
@echo off
hexo clean && hexo deploy

Mac/Linux (deploy.sh):

1
2
#!/bin/bash
hexo clean && hexo deploy

在 Mac/Linux 上，你可能需要先给脚本添加执行权限：

1
chmod +x deploy.sh

部署后查看

部署完成后，访问你的 GitHub Pages 地址查看博客：https://88daxiong.github.io

7. 常见问题解决

命令行不工作？

如果你在终端中输入 hexo 相关命令时遇到问题，可能是因为 Hexo 未正确安装或未添加到系统路径。尝试以下方法：

  1. 确保已安装 Node.js
  2. 尝试使用完整路径：npx hexo <命令>

图片无法显示？

  1. 确保图片放在了文章的同名文件夹中
  2. 检查文章中的图片路径是否正确
  3. 确保使用了正确的图片引用语法

部署失败？

  1. 检查 _config.yml 中的部署配置是否正确
  2. 确保 GitHub 令牌（如果使用）未过期
  3. 查看终端输出的错误信息，进行相应处理

8. 进阶技巧

创建草稿

如果你想创建草稿（不会立即发布的文章）：

1
hexo new draft "草稿标题"

草稿会保存在 source/_drafts 目录。要预览草稿，使用：

1
hexo server --draft

将草稿发布为正式文章：

1
hexo publish "草稿标题"

自定义永久链接

如果你想为某篇文章自定义 URL，可以在 Front Matter 中添加 permalink 字段：

1
2
3
4
---
title: 我的文章
permalink: custom-url/
---

使用标签和分类

在 Front Matter 中添加标签和分类，可以更好地组织你的文章：

1
2
3
4
5
6
7
8
9
---
title: 我的文章
tags:
  - 技术
  - 编程
  - Python
categories:
  - 学习笔记
---

9. 总结

通过本教程，你已经掌握了 Hexo 博客的基本操作，包括创建、编辑、预览和部署文章。即使对命令行不熟悉，你也可以通过创建简单的脚本来简化这些操作。随着使用的深入，你会发现 Hexo 提供了更多强大的功能，可以让你的博客更加个性化和专业化。

祝你的博客之旅愉快！