Hexo博客完整使用指南 - 从入门到进阶

Hexo 博客使用方法指南

本文是Hexo博客的完整使用指南，涵盖从基础操作到高级配置的所有内容。

基础命令

1. 清理与生成

hexo clean        # 清理缓存文件 (db.json) 和已生成的静态文件 (public)
hexo g            # 生成静态文件 (generate 的简写)
hexo generate     # 完整写法，生成静态文件

2. 本地预览

hexo server       # 启动本地服务器，默认端口 4000
hexo s            # server 的简写
hexo s -p 5000    # 指定端口号
hexo s --debug    # 启用调试模式

3. 部署

hexo deploy       # 部署到远程服务器
hexo d            # deploy 的简写
hexo g -d         # 生成并部署 (组合命令)
hexo d -g         # 部署并生成 (组合命令)

文章管理

1. 创建文章

hexo new post "文章标题"           # 创建新文章
hexo new "文章标题"               # 默认创建文章
hexo n post "文章标题"            # new 的简写

2. 创建页面

hexo new page "页面名称"          # 创建新页面
hexo new page about              # 创建关于页面
hexo new page categories         # 创建分类页面
hexo new page tags               # 创建标签页面

3. 创建草稿

hexo new draft "草稿标题"         # 创建草稿
hexo publish "草稿标题"           # 将草稿发布为正式文章

常用工作流程

1. 日常写作流程

# 1. 创建新文章
hexo new post "今天的想法"

# 2. 编辑文章 (在 source/_posts/ 目录下)

# 3. 本地预览
hexo clean ; hexo g ; hexo s

# 4. 部署到线上
hexo d

2. 完整部署流程

hexo clean      # 清理缓存
hexo generate   # 生成静态文件
hexo deploy     # 部署

3. 一键部署 (推荐)

hexo clean ; hexo g -d   # 清理、生成、部署一步完成

高级使用

1. 指定配置文件

hexo g --config custom.yml     # 使用自定义配置文件

2. 安全模式

hexo --safe                    # 安全模式，不加载插件和脚本

3. 调试模式

hexo --debug                   # 调试模式，显示详细信息

4. 静默模式

hexo --silent                  # 静默模式，不显示日志

插件和主题

1. 安装插件

npm install hexo-plugin-name --save

2. 安装主题

git clone https://github.com/theme-author/theme-name.git themes/theme-name

3. 列出信息

hexo list post      # 列出所有文章
hexo list page      # 列出所有页面
hexo list route     # 列出路由
hexo list tag       # 列出标签
hexo list category  # 列出分类

实用技巧

1. 监视文件变化

hexo g --watch      # 监视文件变化，自动重新生成
hexo s --watch      # 启动服务器并监视文件变化

2. 强制重新生成

hexo clean ; hexo g --force

3. 检查 Hexo 版本

hexo version        # 查看 Hexo 版本信息

常见问题解决

1. 端口被占用

hexo s -p 4001      # 更换端口号

2. 生成失败

hexo clean          # 先清理缓存
hexo g --debug      # 使用调试模式查看错误信息

3. 部署失败

# 检查 _config.yml 中的 deploy 配置
# 确保 SSH 密钥或令牌配置正确
hexo d --debug      # 使用调试模式查看错误

Front-matter 常用字段

---
title: 文章标题
date: 2025-01-01 12:00:00
updated: 2025-01-01 12:00:00
tags: 
  - 标签1
  - 标签2
categories:
  - 分类1
  - 分类2
excerpt: 文章摘要
permalink: custom-url
cover: /images/cover.jpg
top: true           # 置顶文章
password: 123456    # 加密文章
toc: true           # 显示目录
comments: true      # 允许评论
mathjax: true       # 启用数学公式
---

目录结构说明

blog/
├── _config.yml          # 站点配置文件
├── package.json         # 依赖包信息
├── scaffolds/          # 文章模板
├── source/             # 源文件
│   ├── _drafts/        # 草稿
│   ├── _posts/         # 文章
│   └── _data/          # 数据文件
├── themes/             # 主题
└── public/             # 生成的静态文件