Hexo使用详细介绍

以下是 Hexo 博客框架的详细使用指南，涵盖从安装、配置到部署的全流程，结合知识库信息整理而成：

一、Hexo 简介

Hexo 是一个基于 Node.js 的静态博客框架，以 Markdown 书写文章，通过命令行快速生成静态网页。其核心优势包括：

  • 快速生成：利用 Node.js 技术，秒级生成数百篇博客。
  • 简单易用：通过命令行即可完成文章编写、部署等操作。
  • 主题丰富：提供 400+ 主题，支持高度定制化。
  • 部署灵活：支持 GitHub Pages、Vercel 等多种部署方式。

二、环境准备

1. 安装依赖

  • Node.js & npm：Hexo 运行的基础环境。

    1
    2
    # 官网下载安装（推荐 LTS 版本）
    https://nodejs.cn/download/

  • Git：用于版本控制和部署。

    1
    2
    3
    # 安装 Git
    sudo apt install git  # Ubuntu/Debian
    brew install git      # macOS

  • 编辑器（可选）：推荐 VS Code 或 Typora编写 Markdown。

三、安装 Hexo

1. 全局安装 Hexo CLI

1
npm install -g hexo-cli

2. 创建 Hexo 项目

1
2
3
hexo init myblog  # myblog 为项目名称
cd myblog
npm install       # 安装依赖（国内用户可使用 cnpm 加速）

3. 启动本地服务

1
hexo server      # 启动本地服务器，访问 http://localhost:4000

四、核心配置

1. 主配置文件 (**_config.yml)**

在项目根目录修改配置，关键参数如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 基础配置
title: 你的博客名称
subtitle: 副标题（可选）
description: 博客描述
author: 作者名
language: zh-Hans  # 中文

# 主题配置
theme: landscape  # 默认主题，安装新主题后修改

# 部署配置（以 GitHub Pages 为例）
deploy:
  type: git
  repo: https://github.com/你的GitHub账号/你的仓库名.git
  branch: gh-pages

2. 主题选择与安装

  • 推荐主题：

    • Next：功能强大，适合新手（GitHub）
    • Butterfly：简洁美观，支持暗黑模式（GitHub）
    • Diaspora：极简风格（GitHub）

  • 安装主题（以 Next 为例）：

    1
    git clone https://github.com/theme-next/hexo-theme-next themes/next

    修改 _config.yml 中的 theme: next。

3. 主题自定义

  • Next 主题配置：
    在根目录创建 _config.next.yml，配置主题参数：

    1
    2
    3
    4
    5
    6
    # 示例配置
    scheme: Muse  # 主题风格
    menu:
      主页: /
      归档: /archives
      关于: /about

五、文章管理

1. 新建文章

1
2
hexo new "文章标题"  # 生成 Markdown 文件
# 文件路径：source/_posts/文章标题.md

2. 编写文章

  • Markdown 文件结构：

    1
    2
    3
    4
    5
    6
    7
    8
    ---
    title: 文章标题
    date: 2023-10-05
    tags: [标签1, 标签2]  # 可选
    categories: 分类名   # 可选
    layout: post        # 默认布局
    ---
    正文内容（Markdown 格式）

  • 高级布局：

    • page：创建独立页面（如 about.md），布局设为 page。
    • draft：草稿，存放在 source/_drafts，不会显示在博客中。

3. 预览与生成

1
2
hexo generate    # 生成静态文件（hexo g）
hexo server      # 本地预览

六、部署到 GitHub Pages

1. 配置 GitHub

  1. 创建仓库：
  2. 配置 SSH 密钥（可选）：
1
2
ssh-keygen -t ed25519 -C "你的邮箱"  # 生成 SSH 密钥
  # 将公钥添加到 GitHub 账户设置中的 SSH 公钥

2. 部署步骤

1
2
hexo clean       # 清理缓存
hexo deploy     # 部署到 GitHub Pages（hexo d）

部署成功后，访问 https://你的GitHub账号.github.io 查看博客。

七、高级功能

1. 添加评论系统（Disqus）

  1. 在 Disqus 注册并获取短名称。

  2. 在主题配置中启用评论：

    1
    2
    # 以 Next 主题为例
    disqus_shortname: 你的Disqus短名称

2. SEO 优化

在 _config.yml 中配置：

1
2
3
seo:
  title: 网站SEO标题
  description: 网站SEO描述

YAML

3. 自定义域名

  1. 在 GitHub 仓库设置中，进入 Pages 栏，选择自定义域名。
  2. 在域名服务商处配置 DNS 解析：
    • 添加 CNAME 记录指向 你的GitHub账号.github.io。

八、常见问题解决

1. 主题安装后报错

  • 错误：Error: Failed to load view engine “swig”

  • 解决：

    1
    npm install hexo-renderer-swig

2. 部署失败（权限问题）

  • 解决：

    1
    2
    git config --global user.name "你的GitHub用户名"
    git config --global user.email "你的邮箱"

3. 图片无法显示

  • 解决：
    • 将图片放入 source/images 目录。
    • 在 Markdown 中引用：图片描述。

九、Hexo 命令大全

命令 作用说明
hexo init 初始化项目
hexo new “标题” 新建文章
hexo g 生成静态文件
hexo s 启动本地服务器
hexo d 部署到指定平台
hexo clean 清理缓存文件
hexo version 查看 Hexo 版本

十、资源推荐

十一、总结

通过以上步骤，您可以：

  1. 快速搭建博客：从安装到部署只需 1 小时。
  2. 高效管理内容：通过 Markdown 编写文章，利用主题和插件扩展功能。
  3. 灵活部署：支持 GitHub Pages、Vercel 等多种托管平台。

如需进一步定制（如添加搜索功能、统计代码），可参考主题文档或 Hexo 插件市场！