教程

Hexo 基础功能入门

欢迎来到 Hexo 的世界！本文将通过实例介绍 Hexo 最基础、最常用的功能，帮助你从一个完全的小白变成能够独立维护博客的站长。

1. 什么是 Hexo？

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

核心特点：

  • 极速构建：基于 Node.js，生成速度极快
  • Markdown 支持：专注写作，无需关心 HTML
  • 一键部署：支持 Git、FTP、Rsync 等多种方式
  • 丰富的主题与插件：生态完善，可高度定制

2. 核心命令速查

命令 作用
hexo init <folder> 初始化一个新站点
hexo new "标题" 创建一篇新文章
hexo new page "页面名" 创建独立页面（如关于页）
hexo new draft "标题" 创建草稿（不会公开发布）
hexo server / hexo s 启动本地预览服务器
hexo generate / hexo g 生成静态文件
hexo deploy / hexo d 部署到远程服务器
hexo clean 清除缓存和已生成的文件

最常用的组合：

1
hexo clean && hexo g && hexo s

3. 文章 vs 页面 vs 草稿

文章（Post）

存放在 source/_posts/ 目录下，是博客的主体内容。每篇文章通常有：

  • 发布时间
  • 分类（Categories）
  • 标签（Tags）
  • 评论功能

页面（Page）

存放在 source/ 下的独立目录中，如 source/about/index.md。页面不属于文章流，不会出现在首页列表中，常用于：

  • 关于我
  • 友情链接
  • 留言板

草稿（Draft）

存放在 source/_drafts/ 目录下。草稿默认不会生成到站点中。当你想发布时，可以：

1
hexo publish "草稿标题"

这会将草稿从 _drafts 移动到 _posts。

4. Front-matter 元数据

每篇文章顶部的 YAML 区块就是 Front-matter，它定义了文章的元信息：

1
2
3
4
5
6
7
8
9
---
title: 文章标题
date: 2026-07-25 10:00:00
categories:
  - 教程
tags:
  - Hexo
  - 入门
---

更多高级用法（如置顶、摘要、自定义模板等）请参考本站的 Front-matter 详解 文章。

5. 资源文件夹

Hexo 支持为每篇文章关联一个资源文件夹。在 _config.yml 中开启：

1
post_asset_folder: true

之后每次 hexo new "标题"，Hexo 会自动创建同名文件夹。你可以把图片、附件等放在里面，然后在文章中用相对路径引用：

1
![示例图片](image.png)

本站有一篇专门演示资源文件夹用法的文章，欢迎查看。

6. 下一步

建议你依次浏览本站的示例文章，了解：

  1. Markdown 渲染演示 — 看看 Hexo 如何渲染各种 Markdown 元素
  2. Front-matter 详解 — 掌握文章元数据的全部用法
  3. 资源文件夹演示 — 学会管理文章附件

有任何问题，可以在关于页面找到我的联系方式！