使用 GitHub + Hexo 搭建个人博客全记录

一、创建 GitHub 仓库

1. 新建名为 <用户名>.github.io 的公开仓库
2. 在仓库设置中启用 GitHub Pages（部署后生效）

二、Windows 生成 SSH Key

1
2
3
4

# 打开 Git Bash 执行
ssh-keygen -t rsa -C "your_email@example.com"
# 连续回车使用默认路径
cat ~/.ssh/id_rsa.pub  # 复制输出的全部内容

3. 在 GitHub Settings → SSH and GPG keys 添加新 SSH Key

三、Hexo 安装与初始化

1
2
3
4

npm install hexo-cli -g
hexo init myblog
cd myblog
npm install

四、主题安装问题解决

当 npm install 卡顿时：
1.删除 node_modules 文件夹
2.删除 package-lock.json
3.重新执行 npm install

五、Hexo 核心命令

1
2
3
4
5
6

hexo clean         # 清除缓存
hexo generate      # 生成静态文件（简写 hexo g）
hexo server        # 本地预览（hexo s）
hexo deploy        # 部署到GitHub（hexo d）
hexo g -d          # 生成静态文件并部署
hexo new "文章标题" # 新建文章

六、文章编写规范

1.文章头部 Front-matter：

1
2
3
4
5
6
7
8
9
10
11
12

---
title: 使用 GitHub + Hexo 搭建个人博客全记录
catalog: true
date: 2025-04-22 20:55:33
subtitle: 部署一个个人博客竟如此简单
header-img: /img/header_img/lml_bg.jpg
tags:
- hexo
- 博客
categories:
- 杂七杂八
---

2.图片引用方式：

1

![图片描述](图片路径)

在 _config.yml 中启用资源目录：

1

post_asset_folder: true

创建文章时自动生成同名资源文件夹
图片路径使用相对路径：/文章标题/图片.jpg

七、部署配置

安装部署插件：

1

npm install hexo-deployer-git --save

修改 _config.yml：

1
2
3
4

deploy:
  type: git
  repo: git@github.com:<用户名>/<用户名>.github.io.git
  branch: main

• ← Previous Post
• Next Post →