Hexo博客搭建指南

📖 引言

在萌生了记录学习和生活的想法后，我便开始寻找一个合适的平台。

💡 小贴士：对于电脑小白来说，其实最推荐的是使用微信公众号写推文——学习成本低、传播范围广，而且微信本身就是我们日常离不开的工具，用起来非常方便！

不过，作为一名生信人 🧬，多少还是懂一些电脑操作的（傲娇脸.jpg）。经过一番调研，我最终选择了使用 Hexo 来搭建个人博客。

🤔 为什么选择 Hexo？

优势 说明
✅ 简单易上手 网上教程丰富，官方提供详细的中文文档
✅ 部署方便 一条命令即可推送到 GitHub，对小白超级友好
✅ 主题精美 尤其是 AnZhiYu 主题，界面简洁又好看

最终方案：Hexo + AnZhiYu 主题 🎨

整体构建流程如下：

hexo构建导图
📌 图1. 构建流程

💻 一、环境准备

1.1 🟢 安装 Node.js

前往 Node.js 官网 下载页面。

我使用的是 Ubuntu 系统，因此选择 Linux 下的 nvm + npm 方式安装。

📝 关于 nvm 和 npm 是什么，后续再深入了解~

Node下载页面
📌 图2. Node.js 下载页面

安装步骤：

1
2
3
4
5
6
7
8
9
10
11
12
# Step 1️⃣ 下载并执行 nvm 安装脚本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
\. "$HOME/.nvm/nvm.sh"

# Step 2️⃣ 使用 nvm 安装 Node.js
nvm install 24

# Step 3️⃣ 验证安装
node -v && npm -v

# Step 4️⃣ 配置国内镜像源（加速下载）🚀
npm config set registry https://registry.npmmirror.com

1.2 🟠 安装 Git

在 Linux 下安装 Git 非常简单：

1
2
3
4
5
# 安装 Git（需要管理员权限）
sudo apt-get install git

# 验证安装
git --version

✅ 如果显示版本号，说明安装成功！

🔗 二、配置 GitHub

接下来，我们需要配置 Git 密钥并连接 GitHub。这样后续更新博客时，就可以直接用命令推送，无需手动操作啦~ 🎉

2.1 👤 配置用户名和邮箱

1
2
git config --global user.name "你的用户名"  
git config --global user.email "你的邮箱"

2.2 🔑 配置 SSH 密钥

Step 1️⃣ 生成密钥

1
2
3
4
5
# 生成 SSH 密钥（连按 3 次回车即可）
ssh-keygen -t rsa -C "你的邮箱"

# 查看公钥内容
cat ~/.ssh/id_rsa.pub

Step 2️⃣ 添加到 GitHub

github密钥
📌 图3. GitHub SSH 密钥配置

操作路径：Settings → SSH and GPG keys → New SSH key

将公钥粘贴进去，点击 Add SSH key 即可 ✨

Step 3️⃣ 验证连接

1
ssh -T git@github.com

首次连接会出现以下提示：

1
2
The authenticity of host 'github.com (20.205.243.166)' can't be established.
Are you sure you want to continue connecting (yes/no/[fingerprint])?

输入 yes 并回车，看到以下信息说明连接成功 🎊：

1
Hi username! You've successfully authenticated, but GitHub does not provide shell access.

2.3 🏠 创建 GitHub Pages 仓库

github仓库
📌 图4. 创建 GitHub 仓库

⚠️ 重要提醒：仓库名称必须是 用户名.github.io 格式！

例如：xuemin-22.github.io

其余参数保持默认，点击 Create repository 完成创建 ✅

🦋 三、部署 Hexo

终于到了激动人心的 Hexo 部署环节！🎉

3.1 📦 安装 Hexo

1
2
3
4
5
6
7
8
9
# 全局安装 Hexo CLI
npm install -g hexo-cli

# 初始化博客目录
hexo init myblog
cd myblog

# 安装依赖
npm install

📂 初始化后，目录下会生成一系列文件，其中 _config.yml 是核心配置文件。

更多详情请参考 Hexo 官方文档 📚

3.2 👀 本地预览

1
2
3
4
5
# 生成静态文件
hexo generate  # 或简写：hexo g

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

🌐 打开浏览器访问 http://localhost:4000 即可预览你的博客！

3.3 🚀 部署到 GitHub Pages

Step 1️⃣ 安装部署插件

1
npm install hexo-deployer-git --save

Step 2️⃣ 配置 _config.yml

在博客根目录的 _config.yml 文件末尾添加：

1
2
3
4
deploy:
  type: git
  repo: git@github.com:你的用户名/你的用户名.github.io.git
  branch: main

Step 3️⃣ 一键部署

1
2
# 清理 → 生成 → 部署（建议每次都这样操作）
hexo clean && hexo g -d

🎊 部署完成后，稍等几分钟就可以访问 https://你的用户名.github.io 啦！

☁️ 四、部署到 Cloudflare Pages（可选）

除了 GitHub Pages，我们还可以将博客部署到 Cloudflare Pages，享受更快的访问速度！⚡

📝 操作步骤

  1. 访问 Cloudflare 官网 并注册账户
  2. 点击右上角 Add → 选择 Pages
  3. 选择 导入现有的 Git 仓库
  4. 授权并选择你的 GitHub 仓库
  5. 保持默认配置，点击 Save and Deploy
部署Cloudflare Pages
📌 图5. 部署 Cloudflare Pages

✅ 部署完成后，Cloudflare 会提供一个 *.pages.dev 域名访问你的博客！

🎯 五、大功告成！

恭喜你！🎉🎉🎉

现在你已经拥有了属于自己的个人博客！快去访问 https://你的用户名.github.io 看看吧~

📋 常用命令速查表

命令 说明
hexo new "文章标题" 📝 新建文章
hexo clean 🧹 清理缓存
hexo g ⚙️ 生成静态文件
hexo s 👀 本地预览
hexo d 🚀 部署到远程
hexo clean && hexo g -d ✨ 一键清理并部署

💬 写在最后

搭建博客只是开始，坚持记录才是最重要的！希望这篇教程对你有所帮助，祝你的博客之旅愉快~ 🌟