如何使用Hexo在GitHub上部署个人博客

一、环境准备

在开始搭建博客之前，需要先准备好以下环境：

1. 安装Git

• 访问 Git官方下载地址
• 下载对应操作系统的安装包并安装（默认选项即可）
• 验证安装：打开命令行，输入 git --version，显示版本信息则安装成功

2. 安装Node.js

• 访问 Node.js官方下载地址
• 下载LTS版本并安装（默认选项即可）
• 验证安装：打开命令行，输入 node -v，显示版本信息则安装成功

3. 安装Hexo

• 打开命令行，输入：npm install hexo -g
• 验证安装：输入 hexo -v，显示版本信息则安装成功

4. 安装Hexo部署依赖

• 输入：npm install --save hexo-deployer-git

二、Git配置SSH Key

1. 生成SSH Key

• 打开命令行，输入：ssh-keygen -t rsa -C "你的GitHub邮箱"
• 连续按三次回车（使用默认路径和空密码）
• 生成成功后，会在 C:\Users\用户名\.ssh 目录下生成 id_rsa 和 id_rsa.pub 文件

2. 添加SSH Key到GitHub

• 打开 id_rsa.pub 文件，复制其中的全部内容
• 登录GitHub，进入「Settings」→「SSH and GPG keys」
• 点击「New SSH key」，粘贴复制的内容，设置一个标题，点击「Add SSH key」

3. 测试SSH连接

• 输入：ssh -T git@github.com
• 出现 Hi 用户名! You've successfully authenticated... 则表示连接成功

4. 配置Git用户信息

• 输入：git config --global user.name "你的GitHub用户名"
• 输入：git config --global user.email "你的GitHub邮箱"

三、搭建个人博客

1. 初始化Hexo博客

• 选择一个目录作为博客存放位置，例如 D:\Blog
• 进入该目录，输入：hexo init
• 等待初始化完成，会生成博客的基本结构

2. 安装依赖

• 输入：npm install

3. 本地预览

• 生成静态文件：hexo generate（或缩写 hexo g）
• 启动本地服务器：hexo server（或缩写 hexo s）
• 在浏览器访问：http://localhost:4000，可以看到默认主题的博客

四、部署到GitHub

1. 创建GitHub仓库

• 登录GitHub，点击「New repository」
• 仓库名称必须为：用户名.github.io（例如 DFameMaster.github.io）
• 选择「Public」，点击「Create repository」

2. 配置部署信息

• 编辑博客根目录下的 _config.yml 文件
• 找到 deploy 部分，修改为：

  deploy:
    type: git
    repository: git@github.com:用户名/用户名.github.io.git
    branch: main

3. 部署到GitHub

• 输入：hexo deploy（或缩写 hexo d）
• 部署成功后，在浏览器访问：https://用户名.github.io，可以看到部署的博客

五、编写和发布博客

1. 新建文章

• 输入：hexo new "文章标题"（或缩写 hexo n "文章标题"）
• 在 source/_posts 目录下会生成对应的Markdown文件

2. 编辑文章

• 使用Markdown编辑器打开生成的 .md 文件
• 按照Markdown格式编写文章内容
• 文章头部的Front-matter可以设置标题、日期、标签等信息

3. 发布文章

• 生成静态文件：hexo g
• 部署到GitHub：hexo d
• 访问博客查看发布的文章

六、主题配置

1. 下载主题

• 推荐几个流行的Hexo主题：
  • Matery：现代Material Design风格

    git clone https://github.com/blinkfox/hexo-theme-matery.git themes/matery

  • Next：简约优雅，高度可定制

    git clone https://github.com/next-theme/hexo-theme-next.git themes/next

2. 切换主题

• 编辑 _config.yml 文件，修改 theme 字段：

  theme: matery # 或 next

3. 配置主题

• 进入主题目录，复制 _config.yml 文件为 _config.主题名.yml
• 根据主题文档修改配置文件
• 重新生成并部署：hexo clean && hexo g && hexo d

七、常见问题解决

1. 部署失败：Deployer not found: git

• 解决方案：安装部署依赖 npm install --save hexo-deployer-git

2. SSH连接失败：Permission denied (publickey)

• 解决方案：检查SSH Key是否正确添加到GitHub，或使用HTTPS方式部署

3. 本地预览报错：line.mathALL is not function

• 解决方案：升级Node.js到12.0.0以上版本，或修改 _config.yml 中 highlight->enable 为 false

八、总结

通过以上步骤，你已经成功搭建了一个基于GitHub Pages的Hexo博客。你可以：

• 定期更新博客内容
• 自定义主题样式
• 集成各种插件和功能
• 分享你的技术心得和生活感悟

祝你在博客之路上越走越远！