Hexo 博客搭建完全指南

前言

Hexo 是一款基于 Node.js 的静态博客框架，无需服务器即可搭建高性能博客。相比传统动态博客系统（如 Typecho、WordPress），静态博客具有加载速度快、安全性高、部署简单等显著优势。本文将详细介绍如何从零开始搭建 Hexo 博客。

准备工作

安装 Node.js

访问 Node.js 官方网站 下载最新版本，建议选择 LTS 版本以获得更好的稳定性。

安装完成后验证版本：

node -v
npm -v

安装 Git

访问 Git for Windows 下载安装包。Git 用于版本控制和部署到 GitHub。

验证安装：

git --version

安装 Hexo

全局安装 Hexo CLI

npm install -g hexo-cli

初始化博客项目

创建项目目录并进入：

mkdir my-blog
cd my-blog

初始化 Hexo 项目：

hexo init
npm install

本地预览

执行以下命令启动本地服务器：

hexo generate  # 生成静态文件
hexo server    # 启动预览服务器

访问 http://localhost:4000 即可查看博客效果。

部署到 GitHub Pages

创建 GitHub 仓库

1. 注册并登录 GitHub
2. 创建新仓库，命名格式为 username.github.io（username 为你的 GitHub 用户名）

配置 SSH 密钥

生成 SSH 密钥：

ssh-keygen -t rsa -C "your_email@example.com"

查看公钥内容：

cat ~/.ssh/id_rsa.pub

访问 GitHub SSH 设置页面，将公钥添加到账户中。

验证配置：

ssh git@github.com

配置部署信息

编辑 _config.yml 文件，配置部署选项：

deploy:
  type: git
  repo: git@github.com:username/username.github.io.git
  branch: main

安装部署插件：

npm install hexo-deployer-git --save

执行部署

hexo clean
hexo generate
hexo deploy

部署成功后，访问 https://username.github.io 即可看到你的博客。

后续优化

• 更换主题：在 Hexo 主题仓库 选择喜欢的主题
• 配置个性化：修改 _config.yml 配置博客标题、描述等信息
• 添加插件：如 hexo-generator-sitemap 生成站点地图

通过以上步骤，你已经成功搭建了一个属于自己的 Hexo 静态博客！