Hexo博客创建关键步骤与要点

一、环境准备

1. 安装Node.js

• 版本要求：Node.js 14.0.0 或更高版本

• 安装方法：

  • Windows/macOS：从 Node.js官网 下载对应安装包

  • Linux：使用包管理器

    1 2 3 4 5

    # Ubuntu/Debian sudo apt update && sudo apt install nodejs npm # CentOS/RHEL sudo dnf install nodejs npm

• 验证安装：

  1 2	node -v # 查看Node.js版本 npm -v # 查看npm版本

2. 安装Git

• 安装方法：

  • Windows：下载 Git for Windows

  • macOS：brew install git（需先安装Homebrew）

  • Linux：

    1 2	sudo apt install git # Ubuntu/Debian sudo dnf install git # CentOS/RHEL

• 验证安装：

  1	git --version

二、Hexo安装与初始化

1. 安装Hexo CLI

1

npm install -g hexo-cli

• 权限问题解决（Linux/macOS）：

  1	sudo npm install -g hexo-cli # 或使用nvm管理Node.js版本

2. 初始化博客项目

1
2
3
4
5
6

# 创建博客目录并初始化
hexo init my-blog
cd my-blog

# 安装依赖
npm install

3. 验证初始化结果

1
2
3
4

# 启动本地服务器
hexo server  # 或简写 hexo s

# 访问 http://localhost:4000 查看默认博客页面

三、基本配置（_config.yml）

1. 核心配置项

1
2
3
4
5
6
7
8
9
10
11
12

# Site
title: 我的博客          # 网站标题
subtitle: '技术分享'     # 网站副标题
description: '个人技术博客' # 网站描述（用于SEO）
author: John Doe         # 作者名称
language: zh-CN          # 语言（中文：zh-CN，英文：en）
timezone: Asia/Shanghai  # 时区

# URL
url: https://yourusername.github.io  # 网站域名（部署后生效）
root: /                              # 网站根目录
permalink: :year/:month/:day/:title/ # 文章永久链接格式

2. 配置生效

修改配置后需重启服务器或执行 hexo clean 清除缓存。

四、主题选择与配置

1. 主流主题推荐

• Next：简洁高效，支持多种布局
  GitHub仓库
• Butterfly：美观功能丰富，适合新手
  GitHub仓库
• Fluid：现代化设计，响应式布局
  GitHub仓库

2. 安装主题（以Next为例）

1
2
3
4
5

# 进入博客目录
cd my-blog

# 克隆主题到themes目录
git clone https://github.com/next-theme/hexo-theme-next themes/next

3. 启用主题

修改博客根目录 _config.yml：

1

theme: next  # 主题文件夹名称

4. 主题个性化配置

• 复制主题目录下的 _config.yml 到博客根目录，并重命名为 _config.next.yml（推荐）
• 配置导航菜单、侧边栏、配色方案等（参考主题官方文档）

五、内容创建与管理

1. 创建新文章

1
2

hexo new "文章标题"  # 生成文章到 source/_posts/目录
hexo new page "关于我" # 生成独立页面到 source/关于我/index.md

2. Front-matter参数（文章头部）

1
2
3
4
5
6
7
8
9
10
11

---
title: 文章标题          # 标题（必填）
date: 2023-10-01 12:00:00 # 发布日期
tags: [Hexo, 博客]       # 标签（数组）
categories: 技术教程     # 分类（单个）
description: 文章简介    # 用于SEO和列表页展示
thumbnail: /images/cover.jpg # 文章封面图
---

# 正文内容
使用Markdown语法编写...

3. 草稿与发布

• 草稿：文章保存到 source/_drafts/，需执行 hexo server --draft 预览
• 发布草稿：hexo publish draft "草稿标题"（自动移动到_posts目录）

4. 生成静态文件

1
2

hexo generate  # 或简写 hexo g，生成文件到 public/目录
hexo clean     # 清除缓存和已生成文件（修改配置或主题后建议执行）

六、部署发布

1. 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/yourusername/yourusername.github.io.git
  branch: main  # 部署分支（GitHub默认main，旧版为master）
  message: "Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }}"  # 提交信息

步骤3：执行部署

1

hexo deploy  # 或简写 hexo d（需先执行 hexo clean && hexo g）

2. 其他部署平台

• Netlify：连接GitHub仓库，设置构建命令 hexo generate，输出目录 public
• Vercel：类似Netlify，支持自动部署
• 个人服务器：通过FTP或SSH将public目录文件上传到服务器根目录

七、进阶优化要点

1. 插件推荐

• 搜索功能：hexo-generator-searchdb

  1	npm install hexo-generator-searchdb --save

• 代码高亮：Next主题默认支持，可在主题配置中开启Prism.js

• 评论系统：Valine（基于LeanCloud）、Gitalk（基于GitHub Issues）

2. SEO优化

• 配置description和keywords（可在主题配置中设置全局关键词）
• 使用hexo-generator-sitemap生成站点地图
• 提交网站到百度/Google搜索资源平台

3. 自定义域名

• 在GitHub仓库设置中添加自定义域名（需提前解析域名到GitHub服务器）
• 在博客根目录添加CNAME文件，内容为自定义域名

八、常用Hexo命令总结