Hexo博客平台搭建记录

HEXO 是一款快速、简洁且高效的博客框架，基于 Node.js 运行。它最核心的特点是将 Markdown 文档解析成静态网页（HTML/CSS/JS），由于不需要数据库支持，加载速度极快，且非常适合部署在 GitHub Pages 或 Vercel 等平台上。

一、 HEXO 的核心简介

• 超快速度：得益于 Node.js，即使有数百篇文章，也能在几秒钟内生成静态页面。
• 一键部署：只需一条命令，即可将博客发布到 GitHub Pages、GitLab 或服务器。
• 丰富的插件与主题：拥有成熟的生态系统，支持各种自定义功能（如搜索、评论、数学公式等）。
• Markdown 支持：支持所有 Markdown 特性，让写作回归纯粹。

二、 环境准备

在安装 Hexo 之前，你的电脑需要安装以下两个软件：

1. Node.js (建议 LTS 版本)
2. Git (用于管理和部署代码)

三、 部署步骤（本地搭建）

1. 安装 Hexo-cli

打开终端（Windows 的 CMD 或 PowerShell，Mac 的 Terminal），输入：

Bash

1

npm install -g hexo-cli

2. 初始化博客项目

选择一个文件夹，执行以下命令：

Bash

1
2
3

hexo init my_blog
cd my_blog
npm install

此时，my_blog 就是你的博客根目录。

3. 生成与本地预览

Bash

1
2

hexo g   # generate，生成静态文件
hexo s   # server，启动本地预览

启动后，在浏览器访问 http://localhost:4000，你就能看到 Hexo 的默认页面了。

四、 将博客部署到 GitHub Pages

这是最常见的玩法，让全球用户都能通过 yourname.github.io 访问你的博客。

1. 创建 GitHub 仓库

在 GitHub 上创建一个新仓库，名称必须为：你的用户名.github.io。

2. 配置部署插件

在博客根目录执行：

Bash

1

npm install hexo-deployer-git --save

3. 修改配置文件 _config.yml

打开根目录下的 _config.yml，拉到最底部，修改为：

YAML

1
2
3
4

deploy:
  type: git
  repo: https://github.com/你的用户名/你的用户名.github.io.git
  branch: main

如何添加GitHub公钥

1. 在终端运行命令获取公钥内容：

   PowerShell

   1	cat ~/.ssh/id_rsa.pub

   （如果没有这个文件，请运行 ssh-keygen -t rsa -b 4096 重新生成，一路回车即可）

2. 复制以 ssh-rsa 开头的整段长字符串。

3. 登录 GitHub，点击右上角头像 -> Settings -> SSH and GPG keys。

4. 点击 New SSH key，Title 填 My-PC，Key 粘贴刚才复制的内容。

5. 点击 Add SSH key。

2. 在终端运行命令获取公钥内容：

在终端输入以下命令：

PowerShell

1

ssh -T git@github.com

• 如果看到： Hi [你的用户名]! You've successfully authenticated... —— 成功！ 请直接跳到第三步。
• 如果依然显示： Permission denied —— 说明你本地的私钥没加载。

解决办法（如果测试失败）： 运行以下两行命令手动加载私钥：

PowerShell

1
2

ssh-agent -s
ssh-add ~/.ssh/id_rsa

3. 尝试部署

直接运行：

PowerShell

1

hexo d

4. 署部署三部曲

Bash

1
2
3

hexo clean   # 清理缓存
hexo g       # 生成页面
hexo d       # 部署到 GitHub

五、 常用命令速查表

六、：备份源码（保护数据）

为了防止电脑坏了导致 Markdown 原稿丢失，我们要把 source 等文件推送到源码仓库：

PowerShell

1
2
3

git add .
git commit -m "更新文章"
git push origin main