1. 环境搭建

1. 1安装 Node.js & Git

去官网下载Node.js — Download Node.js® | Git - 安装 Git

  • 下载并安装Node.js（推荐LTS版本），验证安装：node -v 和 npm -v
  • 安装Git并配置全局用户名和邮箱：
1
2
git config --global user.name "YourName"
git config --global user.email "email@example.com"

1.1.1 NPM 和 Git/Github 镜像设置

1.2 安装 Hexo CLI

1
2
npm install -g hexo-cli
hexo --version  # 验证安装

2.Hexo 基础操作

2.1 初始化博客

1
2
3
hexo init my-blog  # 创建站点目录
cd my-blog
npm install        # 安装依赖

2.2 本地预览与生成

  • 启动本地服务器：hexo s（默认端口4000）
  • 生成静态文件：hexo g（简写为hexo g）
  • 清理缓存：hexo clean

2.3 文章管理

  • 新建文章：hexo new “文章标题”（自动生成source/_posts目录下的.md文件）
  • 草稿管理：hexo draft创建草稿，hexo publish发布草稿

2.4 Front-matter配置

在文章头部添加元数据，例如：

1
2
3
4
5
6
7
---
title: 文章标题
date: 2024-07-30
tags: [Hexo, 教程]
categories: 技术
description: 文章摘要
---

3.主题配置

3.1 安装主题

通过Git克隆主题到themes目录（以Butterfly为例）：

1
git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

修改_config.yml中的theme: butterfly启用主题

3.2 主题自定义

  • 修改主题配置文件（如themes/butterfly/_config.yml）调整颜色、布局、菜单等
  • 添加自定义CSS/JS：在主题目录的source下创建文件并引入

3.3 热门主题推荐

  • Next：高度可定制，支持数学公式、代码高亮
  • Fluid：响应式设计，适合技术博客
  • Yilia：简洁轻量，适合快速搭建

4. 部署到GitHub Pages

4.1 创建GitHub仓库

  • 仓库名格式：用户名.github.io（需公开）

4.2 配置SSH密钥（避免密码输入）

1
2
ssh-keygen -t rsa -C "email@example.com"
cat ~/.ssh/id_rsa.pub  # 复制到GitHub账户的SSH Keys

4.3 部署配置

修改_config.yml的deploy部分：

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

4.4 一键部署

1
hexo clean && hexo g -d  # 生成并部署

5. 进阶功能

5.1 SEO优化

  • 百度收录：安装hexo-baidu-url-submit插件
  • 站点地图：hexo-generator-sitemap生成sitemap.xml

5.2 评论与社交

  • Disqus：在主题配置中启用
  • Valine：轻量级评论系统，需配置LeanCloud

5.3 数学公式支持

1
npm install hexo-renderer-mathjax --save

在文章Front-matter中开启mathjax: true

5.4 代码高亮

安装hexo-prism-plugin，支持多种语言高亮

6. 常见问题解决

6.1 部署失败

  • 检查SSH配置或改用HTTPS仓库地址
  • 确保hexo-deployer-git插件已安装

6.2 主题不生效

  • 清理缓存：hexo clean后重新生成
  • 检查主题配置文件语法

6.3 自定义域名解析

  • 在DNS服务商处添加CNAME记录指向用户名.github.io

7. 资源推荐

通过以上步骤，可快速搭建个性化Hexo博客并部署至GitHub。如需进一步定制，可参考各主题的Wiki文档或社区教程。