使用 GitHub 和 Hexo 搭建个人博客（基础版）

2019-01-15 网站/博客搭建
目录
前言
什么是 Hexo？
环境准备：安装 Node.js
Windows 安装
macOS 安装
Linux 安装
安装 Hexo
初始化博客
本地预览
配置站点信息
安装 Next 主题
安装主题
启用主题
Next 主题配置
创建新文章
生成静态文件
部署到 GitHub Pages
创建 GitHub 仓库
安装部署插件
配置部署信息
部署
绑定自定义域名
第一步：添加 CNAME 文件
第二步：配置 DNS
第三步：等待生效
第四步：强制 HTTPS
常用 Hexo 命令总结
结语

前言

在众多静态博客生成器中，Hexo 以其简洁、快速、基于 Node.js 的特性，成为许多开发者的首选。配合 GitHub Pages 提供的免费静态网站托管服务，我们可以零成本搭建一个属于自己的个人博客。

本文将手把手教你从零开始，使用 Hexo + GitHub Pages 搭建个人博客，并配置 Next 主题和自定义域名。

什么是 Hexo？

Hexo 是一个快速、简洁且高效的静态博客框架，基于 Node.js 开发。它可以将 Markdown 文档快速解析生成静态 HTML 页面。

核心特点：

  • 支持 Markdown 写作，语法友好
  • 生成速度极快（支持多线程渲染）
  • 丰富的主题和插件生态
  • 一键部署到 GitHub Pages、Vercel、Netlify 等平台
  • 支持自定义主题和扩展

环境准备：安装 Node.js

Hexo 依赖 Node.js 环境，首先需要安装 Node.js。

Windows 安装

  1. 访问 Node.js 官网 下载 LTS 版本
  2. 双击安装包，一路 Next 完成安装
  3. 打开命令提示符，验证安装：
node -v
npm -v

macOS 安装

推荐使用 Homebrew：

brew install node

Linux 安装

# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# CentOS/RHEL
sudo yum install nodejs npm

建议使用 Node.js 14.x 或以上版本以获得最佳兼容性。

安装 Hexo

全局安装 Hexo CLI：

npm install -g hexo-cli

验证安装：

hexo -v

初始化博客

创建一个新博客项目：

hexo init my-blog
cd my-blog
npm install

目录结构如下：

my-blog/
├── _config.yml       # 站点配置文件
├── package.json      # 依赖信息
├── scaffolds/        # 模板文件
├── source/           # 文章源码目录
│   └── _posts/       # 博客文章存放处
├── themes/           # 主题目录
└── public/           # 生成的静态文件（执行 hexo generate 后产生）

本地预览

启动本地服务器：

hexo server
# 或简写
hexo s

访问 http://localhost:4000 即可看到默认博客页面。

配置站点信息

编辑 _config.yml：

# 站点标题
title: 我的个人博客

# 副标题
subtitle: 记录技术与生活

# 站点描述
description: 分享编程经验、技术笔记和生活感悟

# 作者
author: 你的名字

# 语言（中文）
language: zh-CN

# 时区
timezone: Asia/Shanghai

# 首页文章每页显示数量
per_page: 10

# 文章链接格式
permalink: :year/:month/:day/:title/

安装 Next 主题

NexT 是最受欢迎的 Hexo 主题之一，设计简洁优雅。

安装主题

cd my-blog
git clone https://github.com/next-theme/hexo-theme-next themes/next

启用主题

编辑 _config.yml，修改：

theme: next

Next 主题配置

在 themes/next/_config.yml 中进行主题配置：

# 选择方案（Muse / Mist / Pisces / Gemini）
scheme: Gemini

# 菜单配置
menu:
  home: / || fa fa-home
  archives: /archives/ || fa fa-archive
  categories: /categories/ || fa fa-th
  tags: /tags/ || fa fa-tags
  about: /about/ || fa fa-user

# 社交链接
social:
  GitHub: https://github.com/yourusername || fab fa-github
  Email: mailto:your@email.com || fa fa-envelope

# 代码高亮主题
highlight_theme: night eighties

创建新文章

hexo new "我的第一篇文章"

文章将创建在 source/_posts/我的第一篇文章.md，编辑内容：

---
title: 我的第一篇文章
date: 2019-01-15 12:00:00
tags: [Hexo, 教程]
categories: 编程
---

这是我的第一篇博客文章！

生成静态文件

hexo generate
# 或简写
hexo g

部署到 GitHub Pages

创建 GitHub 仓库

  1. 登录 GitHub，新建仓库
  2. 仓库名必须为 <你的用户名>.github.io（例如 zhangsan.github.io）
  3. 仓库设置为 Public

安装部署插件

npm install hexo-deployer-git --save

配置部署信息

编辑 _config.yml：

deploy:
  type: git
  repo: https://github.com/yourusername/yourusername.github.io.git
  branch: main

部署

hexo clean
hexo generate
hexo deploy
# 或一键执行
hexo clean && hexo g && hexo d

几分钟后访问 https://yourusername.github.io 即可看到博客。

绑定自定义域名

如果你有自己的域名，可以绑定到 GitHub Pages。

第一步：添加 CNAME 文件

在 source/ 目录下创建 CNAME 文件，内容为你的域名：

blog.yourdomain.com

第二步：配置 DNS

在你的域名服务商处添加 CNAME 记录：

类型 主机记录 记录值
CNAME blog yourusername.github.io

第三步：等待生效

DNS 生效通常需要 10 分钟到 48 小时，请耐心等待。

第四步：强制 HTTPS

在 GitHub 仓库的 Settings → Pages → 勾选 Enforce HTTPS。

常用 Hexo 命令总结

命令 简写 说明
hexo init <folder> - 初始化博客
hexo new <title> hexo n 新建文章
hexo generate hexo g 生成静态文件
hexo server hexo s 启动本地服务器
hexo deploy hexo d 部署到远程
hexo clean - 清除缓存和静态文件

结语

至此，你已经成功搭建了一个基于 Hexo 和 GitHub Pages 的个人博客！接下来可以探索更多功能：

  • 添加评论系统（Gitalk / Valine / Disqus）
  • 配置 SEO 优化
  • 添加站内搜索
  • 自定义主题样式
  • 配置 RSS 订阅

在后续文章中，我们还将介绍如何使用 Hermes Agent 实现自动化写作和部署，敬请期待！