Hexo 常用命令

1. 创建命令

创建新文章

1
2
3
hexo new "文章标题"
# 或简写
hexo n "文章标题"

创建新页面

1
2
3
hexo new page "页面名称"
# 或简写
hexo n page "页面名称"

创建类别页面

1
2
3
hexo new page categories
# 或简写
hexo n page categories

创建标签页面

1
2
3
hexo new page tags
# 或简写
hexo n page tags

生成和预览

生成静态文件

1
2
3
hexo generate
# 或简写
hexo g

启动本地服务器

1
2
3
4
5
hexo server
# 或简写
hexo s
# 指定端口
hexo s -p 4000

生成并启动服务器

1
2
3
4
5
hexo generate --watch
hexo server --watch
# 或简写
hexo g -w
hexo s -w

部署命令

部署到远程仓库

1
2
3
hexo deploy
# 或简写
hexo d

生成并部署

1
2
3
hexo generate --deploy
# 或简写
hexo g -d

清理命令

清理缓存和生成的文件

1
hexo clean

清理后重新生成

1
hexo clean && hexo generate

类别相关命令

创建类别页面

1
2
3
4
# 创建类别索引页面
hexo new page categories
# 或简写
hexo n page categories

列出所有分类

1
2
3
hexo list category
# 或简写
hexo list cat

在文章中使用类别

在文章的 front matter 中设置类别：

1
2
3
4
5
6
7
8
9
10
---
title: 文章标题
date: 2025-12-24
categories: 
  - 技术
  - 前端
tags: 
  - JavaScript
  - Vue
---

或者使用单个类别：

1
2
3
4
5
6
---
title: 文章标题
date: 2025-12-24
categories: 技术
tags: JavaScript
---

创建特定类别页面（可选）

1
2
# 如果需要为特定类别创建独立页面
hexo new page "categories/技术"

在 _posts 目录下按类别组织文件

是的，可以在 _posts 目录下按不同类别放置 md 文件！

Hexo 默认会递归扫描 source/_posts/ 目录下的所有子目录，所有 .md 文件都会被识别为文章，无论它们在哪个子目录中。

文件组织方式示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
source/_posts/
├── 📁 技术/
│   ├── 📁 JavaScript/
│   │   ├── 📄 vue入门.md
│   │   └── 📄 react基础.md
│   ├── 📁 Python/
│   │   └── 📄 django教程.md
│   └── 📁 数据库/
│       └── 📄 mysql优化.md
├── 📁 生活/
│   ├── 📁 旅行/
│   │   └── 📄 北京游记.md
│   └── 📁 美食/
│       └── 📄 家常菜谱.md
└── 📁 学习/
    └── 📄 读书笔记.md

或者使用更简洁的文本格式：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
source/_posts/
│
├─ 技术/
│  ├─ JavaScript/
│  │  ├─ vue入门.md
│  │  └─ react基础.md
│  ├─ Python/
│  │  └─ django教程.md
│  └─ 数据库/
│     └─ mysql优化.md
│
├─ 生活/
│  ├─ 旅行/
│  │  └─ 北京游记.md
│  └─ 美食/
│     └─ 家常菜谱.md
│
└─ 学习/
   └─ 读书笔记.md

注意事项

  1. 文件路径不影响 URL：无论文件在哪个子目录，文章的 URL 仍然由 permalink 配置决定（默认是 :year/:month/:day/:title/）

  2. 类别需要在 front matter 中设置：文件路径不会自动成为类别，需要在文章的 front matter 中明确设置 categories 字段

  3. 资源文件夹：如果 post_asset_folder: true（默认开启），Hexo 会为每篇文章创建一个同名的资源文件夹，用于存放图片等资源

手动创建分类目录结构

1
2
3
4
5
6
7
# 在 _posts 目录下创建分类文件夹
mkdir source/_posts/技术
mkdir source/_posts/技术/JavaScript
mkdir source/_posts/生活

# 然后可以直接在这些目录下创建 md 文件
# 或者使用 hexo new 命令创建后手动移动

推荐做法

虽然可以按类别组织文件，但更推荐的做法是：

  • 使用 front matter 中的 categories 字段来管理分类
  • 文件可以统一放在 _posts 根目录，通过类别字段来分类
  • 或者按类别组织文件，便于文件管理，但记得在 front matter 中设置类别

两种方式都可以，选择适合你的方式即可！

其他命令

列出所有文章

1
hexo list post

列出所有页面

1
hexo list page

列出所有标签

1
hexo list tag

发布草稿

1
2
3
hexo publish "草稿标题"
# 或简写
hexo p "草稿标题"

常用组合命令

清理、生成、部署

1
hexo clean && hexo generate && hexo deploy

清理、生成、启动服务器

1
hexo clean && hexo generate && hexo server

生成并监听文件变化

1
hexo generate --watch

命令参数说明

  • --draft: 显示草稿
  • --config: 使用自定义配置文件
  • --debug: 调试模式
  • --silent: 静默模式
  • --port: 指定端口号
  • --log: 启用日志记录

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 创建新文章
hexo new "我的第一篇博客"

# 启动本地服务器预览
hexo server

# 生成静态文件
hexo generate

# 部署到 GitHub Pages
hexo deploy

# 完整流程：清理 -> 生成 -> 部署
hexo clean && hexo g && hexo d