Hexo 常用命令速查

整理日常使用频率最高的 Hexo 命令，以及它们对应的 npm run 快捷方式。

核心命令

常用参数组合

1
2
3
4
5
6
7
8
9
10
11

# 指定端口启动，并允许局域网访问
hexo server -p 5000 -i 0.0.0.0

# 生成后实时监听文件变化（需 hexo-browsersync 等插件）
hexo generate --watch

# 清缓存 + 重新生成 + 部署，一条命令搞定
hexo clean && hexo generate && hexo deploy

# 生成草稿预览（草稿放在 source/_drafts/）
hexo server --draft

写作相关的 Front-matter

文章开头的 YAML 区块决定标题、日期、分类与标签：

1
2
3
4
5
6
7
8

---
title: 文章标题
date: 2026-11-06 22:30:00
categories: 教程
tags:
  - Hexo
  - 命令行
---

用 <!-- more --> 可以手动截断首页摘要，摘要之后的内容只在文章详情页显示。

排错思路

1. 页面 404 或内容没更新：先执行 hexo clean 再 hexo generate。
2. 依赖报错：删除 node_modules/ 后重新 npm install。
3. 主题不生效：确认 _config.yml 中 theme 的值与主题目录（或 npm 包名）一致。