零基础搭建 Hexo 博客教程：从入门到部署

🚀 为什么选择 Hexo？

Hexo 是一个快速、简洁且功能强大的静态博客框架，基于 Node.js 构建，支持 Markdown 语法，拥有丰富的主题和插件生态，特别适合技术博客和个人记录。

🔧 前置条件

在开始之前，请确保你的设备已经安装了以下环境：

  • Node.js (推荐 LTS 版本)
  • Git (用于版本控制和部署)

可通过以下命令检查是否安装：

1
2
node -v
git --version

🏗️ 安装 Hexo

1. 全局安装 Hexo

使用 npm 进行全局安装：

1
npm install -g hexo-cli

2. 初始化博客项目

在目标文件夹中初始化 Hexo 项目：

1
2
3
4
mkdir my-blog
cd my-blog
hexo init
npm install

🛠️ 配置与主题

1. 基本配置

修改 _config.yml 文件，配置站点信息：

1
2
3
4
title: 我的博客
author: your_name
description: 记录技术与生活
url: https://your_github_username.github.io

2. 选择与安装主题

Hexo 主题市场提供了多样的免费主题，比如 Next、Fluid 等。

以 Next 主题为例：

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

修改 _config.yml 文件：

1
theme: next

✏️ 写作与生成

1. 创建新文章

使用 Hexo 提供的命令快速创建 Markdown 文章：

1
hexo new "我的第一篇博客"

这会在 source/_posts 目录下生成一个 Markdown 文件。

2. 本地预览

在本地运行服务器，查看效果：

1
hexo server

在浏览器打开 http://localhost:4000。

🚢 部署到 GitHub Pages

1. 创建 GitHub 仓库

  • 在 GitHub 上新建一个 your_username.github.io 的仓库。

2. 配置 Hexo 部署

修改 _config.yml 文件，增加以下配置：

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

3. 安装部署插件

1
npm install hexo-deployer-git --save

4. 部署到 GitHub

1
2
3
hexo clean
hexo generate
hexo deploy

📣 常见问题

1. 如何解决部署失败？

  • 确保 _config.yml 文件配置正确。
  • 检查 SSH Key 是否正确配置。

2. 更换主题后样式异常？

  • 重新生成并清理缓存：
1
hexo clean && hexo generate