1. 注册GitHub账号#

• 访问 GitHub官网
• 点击”Sign up”注册新账号
• 记住用户名，将用于生成博客地址

2. 创建GitHub仓库#

• 登录GitHub后，点击右上角”+” → “New repository”
• 仓库名格式：用户名.github.io
• 例如：用户名为john，则仓库名为john.github.io
• 选择”Public”，勾选”Add a README file”

1. 安装Node.js#

1
# Windows/macOS用户
2
# 访问 https://nodejs.org 下载LTS版本安装
3

4
# Ubuntu/Debian
5
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
6
sudo apt-get install -y nodejs
7

8
# 验证安装
9
node -v
10
npm -v

2. 安装Git#

1
# Windows: 下载 https://git-scm.com/download/win
2
# macOS: brew install git
3
# Ubuntu/Debian: sudo apt install git
4

5
# 验证安装
6
git --version

3. 配置Git#

1
# 设置用户信息
2
git config --global user.name "你的用户名"
3
git config --global user.email "你的邮箱"
4

5
# 生成SSH密钥
6
ssh-keygen -t rsa -b 4096 -C "你的邮箱"
7
# 将公钥添加到GitHub
8
cat ~/.ssh/id_rsa.pub

1. 安装Hexo CLI#

1
npm install -g hexo-cli

2. 初始化博客#

1
# 创建博客目录
2
hexo init my-blog
3
cd my-blog
4

5
# 安装依赖
6
npm install
7

8
# 启动本地服务器
9
hexo server
10
# 访问 http://localhost:4000 查看效果

1. 基本配置（_config.yml）#

1
# Site
2
title: 你的博客标题
3
subtitle: 博客副标题
4
description: 博客描述
5
keywords: 关键词1, 关键词2
6
author: 你的名字
7
language: zh-CN
8
timezone: Asia/Shanghai
9

10
# URL
11
url: https://用户名.github.io
12
root: /
13
permalink: :year/:month/:day/:title/
14
permalink_defaults:
15

16
# Directory
17
source_dir: source
18
public_dir: public
19
tag_dir: tags
20
archive_dir: archives
21
category_dir: categories
22
code_dir: downloads/code
23

24
# Writing
25
new_post_name: :title.md
26
default_layout: post
27

28
# Extensions
29
theme: landscape  # 默认主题
30

31
# Deployment
32
deploy:
33
  type: git
34
  repo: https://github.com/用户名/用户名.github.io.git
35
  branch: main

2. 安装部署插件#

1
npm install hexo-deployer-git --save

1. 设置仓库#

1. 进入仓库设置：Settings → Pages
2. Source选择：Deploy from a branch
3. Branch选择：main
4. 文件夹选择：/(root)
5. 点击Save

2. 检查Pages状态#

• 访问 https://用户名.github.io
• 初次部署需要几分钟生效

1. 生成静态文件#

1
# 清理旧文件
2
hexo clean
3

4
# 生成新文件
5
hexo generate
6
# 或简写
7
hexo g

2. 部署到GitHub#

1
# 部署命令
2
hexo deploy
3
# 或简写
4
hexo d
5

6
# 组合命令（常用）
7
hexo clean && hexo g && hexo d

3. 验证部署#

• 访问 https://用户名.github.io
• 查看博客是否正常显示

创建新文章#

1
hexo new "文章标题"
2
# 简写
3
hexo n "文章标题"

创建新页面#

1
hexo new page about
2
# 会在source/about/index.md创建关于页面

本地预览#

1
hexo server
2
# 简写
3
hexo s
4
# 指定端口
5
hexo s -p 8080

草稿功能#

1
# 创建草稿
2
hexo new draft "草稿标题"
3

4
# 预览草稿
5
hexo server --draft
6

7
# 发布草稿
8
hexo publish "草稿标题"

1. 安装主题（以NexT为例）#

1
cd my-blog
2
git clone https://github.com/theme-next/hexo-theme-next themes/next

2. 启用主题#

1
# _config.yml中修改
2
theme: next

3. 配置主题#

• 复制主题配置：cp themes/next/_config.yml _config.next.yml
• 修改_config.next.yml进行自定义配置

4. 推荐主题#

• Next: https://github.com/theme-next/hexo-theme-next
• Butterfly: https://github.com/jerryc127/hexo-theme-butterfly
• Fluid: https://github.com/fluid-dev/hexo-theme-fluid

1. 购买域名#

• 在阿里云、腾讯云等平台购买域名

2. 添加CNAME文件#

1
# 在source目录创建CNAME文件
2
echo "你的域名.com" > source/CNAME

3. 配置DNS#

1
记录类型：CNAME
2
主机记录：www
3
记录值：用户名.github.io

4. 更新GitHub Pages设置#

1. 进入仓库Settings → Pages
2. 在Custom domain填入你的域名
3. 勾选Enforce HTTPS

常见问题#

1. 页面404错误

   • 检查仓库名是否正确
   • 等待几分钟让GitHub Pages生效

2. 部署失败

   1
   # 检查Git配置
   2
   git config --list
   3
   
   4
   # 重新安装部署插件
   5
   npm uninstall hexo-deployer-git
   6
   npm install hexo-deployer-git
   

3. 样式丢失

   1
   # 清理缓存重新生成
   2
   hexo clean && hexo g
   

获取帮助#

• Hexo官方文档：https://hexo.io/zh-cn/docs/
• GitHub Pages文档：https://docs.github.com/pages
• 主题文档：查看各主题的GitHub仓库

1. SEO优化#

• 添加sitemap插件
• 配置robots.txt
• 添加Google Analytics

2. 功能增强#

• 安装评论系统（评论系统类型: twikoo, waline, giscus(github discussions), disqus, artalk都很不错）
• 添加搜索功能
• 配置RSS订阅

3. 自动化部署#

• 使用GitHub Actions自动部署
• 配置Travis CI持续集成

提示：每次修改配置后，记得运行hexo clean && hexo g && hexo d重新部署。