Hexo博客系列 No.1 搭建Hexo博客快速简洁高效，零成本打造个人博客

壹拾贰2025-04-022025-04-05

【Hexo博客系列】No.1 搭建Hexo博客快速简洁高效，零成本打造个人博客：Hexo + GitHub Pages + Cloudflare Pages 完整指南

本文将详细指导你如何利用 Hexo 框架 搭建一个个人博客，并通过 GitHub Pages 和 Cloudflare Pages 实现免费部署。无论你是技术小白还是有一定基础的用户，这个教程都能帮助你快速拥有一个高效、简洁的博客网站。主要内容包括：

环境准备：安装 Node.js 和 Git
GitHub 配置：设置 SSH 密钥，创建仓库
Hexo 初始化：安装 Hexo 并创建博客项目
部署到 GitHub Pages：推送静态文件
部署到 Cloudflare Pages：实现自动部署
基本使用：撰写文章、本地预览与发布

通过 Hexo、GitHub 和 Cloudflare 的免费服务，你无需额外成本即可拥有一个属于自己的博客！

一、事前准备

必备条件

GitHub 账号：必须，用于托管博客仓库
Node.js 和 Git：核心工具，需提前安装

可选条件

域名：非必须，可使用 GitHub.io 或 Pages.dev 提供的免费域名
Cloudflare 账号：非必须，但推荐注册以利用其 CDN 加速博客访问

二、软件安装与配置

2.1 安装 Node.js

访问 Node.js 官网，下载与你系统匹配的安装包。
安装时建议使用默认路径：C:/Program Files/nodejs/。
安装完成后，按 Win + R，输入 cmd，运行 node -v，若显示版本号则安装成功。

配置 npm 源

npm 默认从国外服务器下载模块，速度较慢，建议切换为华为云镜像：

1	npm config set registry https://mirrors.huaweicloud.com/repository/npm/

2.2 安装 Git

访问 Git 官网，下载适合你系统的版本。
安装时建议使用默认路径：C:/Program Files/Git。
安装完成后，桌面或开始菜单会显示 Git CMD（Windows 风格）、Git Bash（Linux 风格，推荐使用）、Git GUI（图形界面，新手不建议）。

三、配置 Git 与 GitHub

3.1 设置用户名和邮箱

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

运行 git config -l 检查配置是否成功。

3.2 配置 SSH 密钥连接 GitHub

生成 SSH 密钥：
1
ssh-keygen -t rsa -C "你的邮箱"
按提示一路回车（新手无需设置密码）。
打开 C:/Users/你的用户名/.ssh/，找到 id_rsa.pub 文件，用记事本打开并复制内容。
登录 GitHub，进入 Settings > SSH and GPG Keys > New SSH Key，粘贴公钥并保存。
测试连接：
1
ssh -T [email protected]
首次连接输入 yes，若显示成功信息则配置完成。

3.3 创建 GitHub.io 仓库

在 GitHub 点击右上角 + > New repository。
仓库名格式为：<用户名>.github.io（必须与用户名一致）。
可见性选择 Public，点击 Create repository 创建。

四、初始化 Hexo 博客

创建一个文件夹（如 D:/Hexo-Blog）用于存放博客源码。
在文件夹内右键选择 Open Git Bash Here。
安装 Hexo：
1
npm install -g hexo-cli && hexo -v
检查安装：运行 hexo -v 查看版本。
初始化项目：
1
2
3
hexo init blog-demo
cd blog-demo
npm i
项目结构说明：
- node_modules：依赖包
- scaffolds：文章模板
- source：存放文章
- themes：主题文件夹
- _config.yml：博客配置文件
启动本地预览：
1
hexo cl && hexo s
浏览器访问 http://localhost:4000，若显示博客页面则成功。

五、部署到 GitHub Pages

安装部署插件：
1
npm install hexo-deployer-git --save

编辑 blog-demo/_config.yml，修改末尾部署配置：

deploy:
  type: git
  repository: [email protected]:<用户名>/<用户名>.github.io.git
  branch: main

部署命令（Hexo 三连）：
1
hexo clean && hexo generate && hexo deploy
- hexo clean：清理旧文件（缩写 hexo cl）
- hexo generate：生成静态文件（缩写 hexo g）
- hexo deploy：部署到 GitHub（缩写 hexo d）
部署成功后，访问 https://<用户名>.github.io 查看博客。

六、部署到 Cloudflare Pages

登录 Cloudflare，进入 Workers and Pages > Pages > Connect to Git。
授权并选择你的 GitHub 博客仓库。
配置项目名称和分支（默认 main），点击 Save and Deploy。
部署完成后，访问 https://<用户名>-github-io.pages.dev 查看博客。
（可选）绑定自定义域名，或将 GitHub 仓库设为私有。

七、基本使用方法

新建文章

1	hexo new "这是一篇新的博文"

编辑 source/_posts/这是一篇新的博文.md，使用 Markdown 格式书写。

本地预览

1	hexo cl && hexo s

访问 http://localhost:4000 检查效果。

发布更新

1	hexo cl && hexo g && hexo d

推送至 GitHub 或 Cloudflare。

详细用法参考 Hexo 官方文档。

八、常见问题

VSCode 终端报错

首次运行可能提示权限问题，以管理员身份打开 PowerShell，输入：

1	Set-ExecutionPolicy RemoteSigned

九、参考资料与致谢

[up主专用，视频内嵌代码贴在这]

微信公众号小贴士：想解锁更多硬核内容？点击左下角【阅读原文】一探究竟！