如何通过 Hexo 和 GitHub Actions 实现自动发布博客 🚀

Kook Up2025-08-152024-08-07

如何通过 Hexo 和 GitHub Actions 实现自动发布博客 🚀

你是否希望自动化发布你的 Hexo 博客，而无需手动操作每次更新？本文将详细介绍如何使用 GitHub Actions 自动化部署你的 Hexo 博客。即使你是小白，也能通过以下步骤轻松上手！📝

前提条件 🌟

在开始之前，你需要以下几个条件：

Hexo 博客系统: 在你的电脑上已经安装并配置好了 Hexo 博客。
GitHub 账户: 你需要一个 GitHub 账户，并在 GitHub 上创建一个用于存储博客代码的仓库。
GitHub Pages: 用于托管你的网站页面的服务，GitHub Pages 是免费的。
基本的 Git 知识: 了解如何使用 Git 进行版本控制和提交代码。

步骤 1: 配置 Hexo 博客 📚

1. 安装 Hexo

如果你还没有安装 Hexo，可以按照以下步骤进行安装：

npm install -g hexo-cli

然后，初始化一个新的 Hexo 博客项目：

hexo init my-blog
cd my-blog
npm install

2. 部署到 GitHub

将你的 Hexo 博客推送到 GitHub 上的仓库：

在 GitHub 上创建一个新的仓库，命名为 my-blog。

在本地项目目录中初始化 Git 并添加远程仓库：

git init
git remote add origin https://github.com/你的用户名/my-blog.git

提交并推送代码：

git add .
git commit -m "Initial commit"
git push -u origin main

步骤 2: 创建 GitHub Actions 工作流 🔄

1. 创建工作流目录

在你的 GitHub 仓库中，创建一个目录用于存放 GitHub Actions 的配置文件：

mkdir -p .github/workflows

2. 添加工作流配置文件

在 .github/workflows 目录中，创建一个名为 deploy.yml 的文件，添加以下内容：

name: Deploy Hexo Blog

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
    - name: Checkout code
      uses: actions/checkout@v3

    - name: Setup Node.js
      uses: actions/setup-node@v3
      with:
        node-version: '16' # 选择 Node.js 的版本

    - name: Install dependencies
      run: npm install

    - name: Build Hexo
      run: npm run generate

    - name: Deploy to GitHub Pages
      uses: peaceiris/actions-gh-pages@v3
      with:
        github_token: ${{ secrets.GITHUB_TOKEN }}
        publish_dir: ./public

配置解释

name: 定义工作流的名称。
on: 触发工作流的条件，这里设置为当 main 分支有新的提交时触发。
jobs: 定义一个作业，这里是 deploy 作业。
steps: 作业中的步骤，包括：
- Checkout code: 检出代码到工作环境。
- Setup Node.js: 设置 Node.js 环境。
- Install dependencies: 安装 Hexo 依赖。
- Build Hexo: 构建 Hexo 博客。
- Deploy to GitHub Pages: 将生成的博客内容发布到 GitHub Pages。

步骤 3: 配置 GitHub Pages 🌐

打开你的 GitHub 仓库页面，点击 Settings。
在左侧菜单中选择 Pages。
在 Source 部分，选择 gh-pages 分支，并点击 Save。

这样设置后，GitHub Pages 就会从 gh-pages 分支中读取你的博客内容并进行展示。

步骤 4: 提交更改并触发自动发布 🔧

在本地项目目录中，提交你对 deploy.yml 文件的更改：

git add .github/workflows/deploy.yml
git commit -m "Add GitHub Actions workflow for deployment"
git push origin main

当你推送到 main 分支时，GitHub Actions 会自动触发，执行配置好的工作流，并将你的博客内容发布到 GitHub Pages。

总结 🏆

通过以上步骤，你已经成功配置了 Hexo 和 GitHub Actions 实现自动化博客发布。每次你更新博客内容并推送到 main 分支时，GitHub Actions 会自动构建并部署你的博客，无需手动操作。这样，你可以更专注于创作内容，而不是部署过程。

希望这篇文章对你有帮助！如果你有任何问题或建议，欢迎在评论区留言。😊

喜欢这篇文章？别忘了给我点个 👍 和关注哦！✨