hexo使用指南

Hexo 博客搭建与使用详细教程

一、Hexo 简介

Hexo 是一个基于 Node.js 的静态博客框架，支持 Markdown 语法，能快速生成静态页面并部署到 GitHub Pages、Vercel 等平台。优势包括：

  • 快速生成页面
  • 丰富的主题和插件
  • 支持 Markdown
  • 易于部署

二、安装前准备

1. 安装 Node.js

1.1 访问 Node.js 官网 下载 LTS 版本

1.2 Linux安装

1
2
3
4
5
6
7
8
9
10
11
12
# 1. 安装 curl 工具（如未安装）
sudo apt-get install -y curl  # Ubuntu/Debian
sudo yum install -y curl     # CentOS/RHEL
sudo dnf install -y curl     # Fedora

# 2. 自动选择适合的安装脚本（LTS版本）
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

# 3. 执行安装
sudo apt-get install -y nodejs  # Ubuntu/Debian
sudo yum install -y nodejs      # CentOS/RHEL
sudo dnf install -y nodejs      # Fedora
  • 安装后验证：
    1
    2
    node -v  # 显示版本号如 v18.x.x
    npm -v    # 显示版本号如 9.x.x

2. 安装 Git

  • Windows/Mac 用户：从 Git官网 下载安装
  • Linux 用户：
    1
    sudo apt-get install git  # Ubuntu/Debian

三、安装 Hexo

1. 全局安装 Hexo

1
npm install -g hexo-cli

2. 初始化博客项目

1
2
3
hexo init myblog  # 创建名为 myblog 的文件夹
cd myblog
npm install       # 安装依赖包

四、目录结构说明

1
2
3
4
5
6
7
8
.
├── _config.yml       # 全局配置文件
├── package.json      # 项目依赖配置
├── scaffolds         # 模板文件夹
├── source            # 用户资源
│   ├── _drafts       # 草稿
│   └── _posts        # 已发布文章
└── themes            # 主题文件夹

五、创建内容

1. 新建文章

1
hexo new "我的第一篇文章"

生成文件：source/_posts/我的第一篇文章.md

2. 编辑文章（Markdown）

1
2
3
4
5
6
7
---
title: 我的第一篇文章
date: 2023-10-01
categories: [教程]
tags: [Hexo, 博客]
---
这里是正文内容，**支持Markdown语法**。

3. 新建页面（如「关于」页面）

1
hexo new page about

生成文件：source/about/index.md

六、生成与预览

1. 生成静态文件

1
2
hexo clean    # 清除缓存
hexo generate # 或 hexo g

2. 本地启动服务器

1
hexo server   # 或 hexo s

访问 http://localhost:4000 查看效果

七、主题安装与配置

1. 下载主题（以 Fluid 为例）

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

2. 修改全局配置

编辑 _config.yml：

1
theme: fluid

3. 配置主题

复制主题配置文件：

1
cp themes/fluid/_config.yml themes/fluid/_config.example.yml

修改 themes/fluid/_config.yml 自定义样式和功能

八、部署到 GitHub Pages

1. 创建 GitHub 仓库

仓库名格式：<用户名>.github.io

2. 安装部署插件

1
npm install hexo-deployer-git --save

3. 配置部署信息

编辑 _config.yml：

1
2
3
4
deploy:
  type: git
  repo: git@github.com:用户名/用户名.github.io.git
  branch: main

4. 执行部署

1
hexo deploy  # 或 hexo d

九、进阶配置

1. 自定义域名

  1. 在域名服务商添加 CNAME 记录
  2. 在博客 source 目录创建 CNAME 文件（无后缀），写入域名
  3. 重新部署

2. SEO 优化

安装 SEO 插件：

1
2
npm install hexo-generator-sitemap --save
npm install hexo-generator-baidu-sitemap --save

3. 添加评论系统

推荐使用 Waline 或 Gitalk，在主题配置文件中添加相关配置

十、日常维护

1. 更新 Hexo

1
npm update -g hexo-cli

2. 备份博客

建议将整个博客目录提交到私有仓库，或使用云存储备份

3. 常用命令组合

1
2
hexo clean && hexo g && hexo s   # 本地调试
hexo clean && hexo g -d          # 清理并部署

十一、常见问题

1. 页面无样式

  • 检查主题是否安装正确
  • 确保 theme 配置与文件夹名称一致

2. 部署失败

  • 检查 SSH 密钥配置
  • 确保 GitHub 仓库权限正确

3. 图片无法显示

  • 将图片放入 source/images 文件夹
  • 使用相对路径：![描述](/images/photo.jpg)

通过以上步骤，你可以完成 Hexo 博客的搭建和基本使用。如需更多功能，可参考 Hexo 官方文档。