Hexo博客快速部署指南

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 使用 Hexo 搭建个人博客并部署到 GitHub

本文将详细介绍如何使用 Hexo 搭建个人博客，并将其部署到 GitHub Pages 上。我们将从环境准备开始，逐步完成 Hexo 项目的创建、配置和部署。

## 一、环境准备

### 1. 安装 Node.js

Hexo 是基于 Node.js 的静态博客框架，因此首先需要安装 Node.js。

- 访问 [Node.js 官网](https://nodejs.org/) 下载并安装适合你操作系统的版本。
- 安装完成后，打开终端或命令提示符，运行以下命令检查是否安装成功：

  ```bash
  node -v
  npm -v

如果显示了版本号，说明 Node.js 和 npm 已成功安装。

2. 安装 Git

Git 是版本控制工具，用于将博客代码推送到 GitHub。

  • 访问 Git 官网 下载并安装 Git。

  • 安装完成后，打开终端或命令提示符，运行以下命令检查是否安装成功：

    1
    git --version

    如果显示了版本号，说明 Git 已成功安装。

3. 安装 Hexo

在安装好 Node.js 和 Git 后，我们可以通过 npm 安装 Hexo。

  • 打开终端或命令提示符，运行以下命令全局安装 Hexo：

    1
    npm install -g hexo-cli

  • 安装完成后，运行以下命令检查是否安装成功：

    1
    hexo -v

    如果显示了 Hexo 的版本信息，说明 Hexo 已成功安装。

4. GitHub 部署准备

为了将博客部署到 GitHub Pages，我们需要在 GitHub 上创建一个仓库。

  • 登录 GitHub，点击右上角的 + 号，选择 New repository。
  • 在仓库名称中输入 <用户名>.github.io，例如 yourusername.github.io。注意：仓库名称必须严格按照此格式。
  • 建议将仓库设置为私密库，因为后续配置中会涉及到 API key 等敏感信息。

5. 配置 Git

在将代码推送到 GitHub 之前，我们需要配置 Git 的用户名和邮箱。

  • 打开终端或命令提示符，运行以下命令配置用户名和邮箱：

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

  • 运行以下命令检查配置是否成功：

    1
    git config -l

    如果显示了刚刚配置的用户名和邮箱，说明配置成功。

6. 连接至 GitHub

为了将本地代码推送到 GitHub，我们需要生成 SSH 密钥并将公钥添加到 GitHub。

  • 打开终端或命令提示符，运行以下命令生成 SSH 密钥：

    1
    ssh-keygen -t rsa -C "你的邮箱"

    按几次回车，使用默认路径和空密码即可。

  • 生成密钥后，打开 C:\Users\<你的用户名>\.ssh 文件夹，找到 id_rsa.pub 文件，用记事本打开并复制其中的内容。

  • 登录 GitHub，点击右上角头像，选择 Settings > SSH and GPG keys > New SSH key。

  • 在 Title 中随意填写一个名称，在 Key 中粘贴刚刚复制的公钥内容，然后点击 Add SSH key。

  • 最后，运行以下命令测试 SSH 连接：

    1
    ssh -T [email protected]

    如果看到 Hi <你的用户名>! You've successfully authenticated... 的提示，说明 SSH 连接成功。

二、新建 Hexo 项目

1. 初始化 Hexo 项目

在桌面或其他文件夹下右键，选择 Open Git Bash here，然后运行以下命令初始化 Hexo 项目：

1
hexo init <项目名>

例如：

1
hexo init my-blog

2. 进入项目目录并安装依赖

初始化完成后，进入刚刚创建的项目目录：

1
cd <项目名>

然后安装项目所需的依赖：

1
npm install

三、配置 Hexo

1. 生成静态文件并启动本地服务器

在项目目录下运行以下命令生成静态文件并启动本地服务器：

1
hexo clean && hexo generate && hexo server

或者简写为：

1
hexo cl; hexo g; hexo s

启动后，打开浏览器访问 http://localhost:4000/，即可预览你的博客。

2. 结束本地服务器

在终端中按下 CTRL + C 即可停止本地服务器。

四、将博客托管到 GitHub

1. 安装 hexo-deployer-git

为了将博客部署到 GitHub，我们需要安装 hexo-deployer-git 插件。

在项目目录下运行以下命令：

1
npm install hexo-deployer-git --save

2. 修改 _config.yml 文件

打开项目根目录下的 _config.yml 文件，找到 deploy 部分，修改为以下内容：

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

例如：

1
2
3
4
deploy:
  type: git
  repository: [email protected]:yourusername/yourusername.github.io.git
  branch: main

3. 部署到 GitHub

修改好配置后，保存文件并运行以下命令将博客部署到 GitHub：

1
hexo clean && hexo generate && hexo deploy

或者简写为：

1
hexo cl; hexo g; hexo d

部署完成后，访问 https://<用户名>.github.io 即可看到你的博客。

结语

至此，你已经成功使用 Hexo 搭建了一个个人博客，并将其部署到了 GitHub Pages 上。接下来，你可以根据自己的需求修改主题、添加文章等，进一步定制你的博客。