hexo使用技巧

Hexo博客完整使用指南

📝 快速命令速查

常用命令组合

1
2
3
4
hexo cl ; hexo g ; hexo d    # 清理+生成+部署到GitHub (一键发布)
hexo cl ; hexo s              # 清理+本地预览
hexo g ; hexo s               # 生成+本地预览(不清理缓存)
hexo s --debug                 # 调试模式启动本地服务器

命令详解

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
hexo clean        # 清理缓存文件 (db.json) 和已生成的静态文件 (public)
hexo cl           # clean 的简写

hexo generate     # 生成静态文件到 public 文件夹
hexo g            # generate 的简写
hexo g --watch    # 监听文件变化并自动生成

hexo server       # 启动本地服务器，默认地址 http://localhost:4000
hexo s            # server 的简写
hexo s -p 5000    # 指定端口号
hexo s --draft    # 预览草稿文章

hexo deploy       # 部署到远程仓库
hexo d            # deploy 的简写
hexo d -g         # 生成后立即部署

📄 文章管理

创建新文章

1
2
3
4
5
6
hexo new "文章标题"                    # 创建普通文章
hexo n "文章标题"                      # new 的简写

hexo new post "文章标题"               # 同上，明确指定类型
hexo new draft "草稿标题"              # 创建草稿
hexo new page "关于"                   # 创建独立页面

文章Front Matter模板

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
---
title: 文章标题
date: 2025-11-10 14:30:00
updated: 2025-11-10 14:30:00
tags: 
  - Hexo
  - 博客
  - 教程
categories: 
  - 技术
  - 前端
keywords: Hexo, 博客搭建, 静态网站
description: 这是文章的简短描述，会显示在搜索结果中
top: false          # 是否置顶
cover: /img/cover.jpg  # 文章封面图
comments: true      # 是否开启评论
---

文章正文内容...

<!-- more -->  <!-- 首页摘要分隔符 -->

更多详细内容...

草稿管理

1
2
3
hexo new draft "草稿标题"              # 创建草稿
hexo s --draft                         # 预览草稿
hexo publish draft "草稿标题"          # 将草稿发布为正式文章

🏷️ 页面管理

创建特殊页面

1
2
3
4
5
hexo new page "tags"          # 创建标签页
hexo new page "categories"    # 创建分类页
hexo new page "about"         # 创建关于页面
hexo new page "archives"      # 创建归档页面
hexo new page "404"           # 创建404页面

标签页配置

创建后编辑 source/tags/index.md:

1
2
3
4
5
6
7
---
title: 标签
date: 2025-11-10
type: "tags"
layout: "tags"
comments: false
---

分类页配置

编辑 source/categories/index.md:

1
2
3
4
5
6
7
---
title: 分类
date: 2025-11-10
type: "categories"
layout: "categories"
comments: false
---

🎨 主题管理

安装主题

1
2
3
4
5
6
# 克隆主题到 themes 目录
cd your-blog
git clone https://github.com/theme-next/hexo-theme-next themes/next

# 或使用 npm 安装
npm install hexo-theme-next

切换主题

编辑 _config.yml:

1
theme: next  # 修改为主题名称

更新主题

1
2
3
4
5
cd themes/your-theme
git pull

# 或使用 npm
npm update hexo-theme-next

🔧 配置优化

网站基本配置 (_config.yml)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# 网站信息
title: 我的博客
subtitle: '记录技术与生活'
description: '专注于前端开发和技术分享'
keywords: 前端,JavaScript,Hexo
author: Your Name
language: zh-CN
timezone: 'Asia/Shanghai'

# URL配置
url: https://yourname.github.io
root: /
permalink: :year/:month/:day/:title/
permalink_defaults:
pretty_urls:
  trailing_index: true
  trailing_html: true

# 部署配置
deploy:
  type: git
  repo: https://github.com/yourname/yourname.github.io.git
  branch: main

提升构建速度

1
2
3
4
5
6
# 安装插件
npm install hexo-generator-search --save      # 搜索功能
npm install hexo-generator-sitemap --save     # 生成sitemap
npm install hexo-generator-feed --save        # RSS订阅
npm install hexo-renderer-pug --save          # Pug渲染
npm install hexo-renderer-sass --save         # Sass支持

🚀 部署到GitHub Pages

1. 安装部署插件

1
npm install hexo-deployer-git --save

2. 配置 _config.yml

1
2
3
4
5
deploy:
  type: git
  repo: https://github.com/username/username.github.io.git
  branch: main
  message: "Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }}"

3. 部署流程

1
2
3
4
5
6
7
# 完整部署流程
hexo clean       # 1. 清理缓存
hexo generate    # 2. 生成静态文件
hexo deploy      # 3. 部署到GitHub

# 或使用组合命令
hexo cl && hexo g && hexo d

4. SSH密钥配置(推荐)

1
2
3
4
5
6
7
8
9
10
11
12
# 生成SSH密钥
ssh-keygen -t rsa -C "your_email@example.com"

# 查看公钥
cat ~/.ssh/id_rsa.pub

# 添加到GitHub Settings -> SSH Keys
# 修改部署配置使用SSH
deploy:
  type: git
  repo: git@github.com:username/username.github.io.git
  branch: main

💡 常用工作流

日常写作流程

1
2
3
4
5
6
7
8
9
10
11
# 1. 创建新文章
hexo new "今天学到的新知识"

# 2. 编辑文章
code source/_posts/今天学到的新知识.md

# 3. 本地预览
hexo s

# 4. 满意后部署
hexo cl && hexo g && hexo d

主题调试流程

1
2
3
4
5
6
7
8
# 1. 清理缓存
hexo clean

# 2. 启动调试模式
hexo s --debug

# 3. 修改主题文件后自动刷新
hexo s --debug --watch

🐛 常见问题解决

1. 部署失败

1
2
3
4
5
6
7
# 清理并重新安装依赖
rm -rf node_modules package-lock.json
npm install

# 检查Git配置
git config --global user.name "Your Name"
git config --global user.email "your_email@example.com"

2. 端口被占用

1
2
3
4
5
6
# 使用其他端口
hexo s -p 5000

# 或查找并结束占用进程
lsof -i:4000
kill -9 PID

3. 文章不显示

1
2
3
# 检查Front Matter格式是否正确
# 清理缓存重新生成
hexo clean && hexo g

4. 主题样式不生效

1
2
3
4
5
# 强制清理缓存
hexo clean

# 删除浏览器缓存或使用无痕模式访问
# Ctrl+Shift+R 强制刷新页面

📦 实用插件推荐

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
# SEO优化
npm install hexo-generator-sitemap --save
npm install hexo-generator-baidu-sitemap --save

# 搜索功能
npm install hexo-generator-search --save

# 图片处理
npm install hexo-image-link --save
npm install hexo-asset-image --save

# 代码高亮
npm install hexo-prism-plugin --save

# 压缩优化
npm install hexo-all-minifier --save

# 字数统计和阅读时长
npm install hexo-word-counter --save

# RSS订阅
npm install hexo-generator-feed --save

🎯 高级技巧

1. 使用Git管理源文件

1
2
3
4
5
# 创建source分支保存源文件
git checkout -b source
git add .
git commit -m "backup source files"
git push origin source

2. 自定义域名

1
2
3
4
5
6
# 在source目录创建CNAME文件
echo "yourdomain.com" > source/CNAME

# 在域名提供商添加DNS记录
# A记录指向: 185.199.108.153
# 或CNAME记录指向: username.github.io

3. 配置GitHub Actions自动部署

创建 .github/workflows/deploy.yml:

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
27
28
name: Deploy Hexo

on:
  push:
    branches: [ source ]

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      
      - name: Setup Node.js
        uses: actions/setup-node@v2
        with:
          node-version: '16'
      
      - name: Install Dependencies
        run: npm install
      
      - name: Build
        run: npm run build
      
      - name: Deploy
        uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: ./public

📚 学习资源

🔖 快速参考卡片

命令 简写 说明
hexo clean hexo cl 清理缓存
hexo generate hexo g 生成静态文件
hexo server hexo s 启动本地服务
hexo deploy hexo d 部署到远程
hexo new hexo n 创建新文章
hexo –version hexo -v 查看版本
hexo –help hexo -h 查看帮助

最后更新: 2025-11-10
提示: 遇到问题先尝试 hexo clean 清理缓存!