自动构建Fuwari博客 - Onimai

551 字

3 分钟

自动构建Fuwari博客

2026-03-14

脚本

Astro

/

GitHub

前言#

现在的个人博客大部分都是静态网页了，一方面避免了服务器的费用，有效降低博客成本

Fuwari 是一个基于 Astro 的静态博客主题，它的博客文章都是 Markdown 格式的，博客之前的文章也有讲

大部分都部署在Vercel或者CloudFlare Pages上，但是这样的方式使用云构建时不时就容易出问题，

比如构建失败，或者构建时间太长，这些问题都比较麻烦。

所以通过 GitHub Actions 自动构建 Fuwari 博客，这样就可以避免这些问题了。

原理#

这个项目的实现比较简单，就是在 GitHub 仓库中添加一个 GitHub Actions 工作流，

当有新的博客文章发布时，就会触发这个工作流，自动构建 Fuwari 博客。

actions/setup-node@v4配置中，我们指定了 Node.js 的版本为 20

corepack enable启用Node.js的Corepack功能

corepack prepare pnpm@latest --activate安装最新版本的PNPM

pnpm --version检查PNPM是否安装成功

执行以上安装依赖和构建的命令

将./dist目录上传到“dist”分支，就实现了自动构建 Fuwari 博客

这样子部署的GitHub Action不需要单独配置GitHub Tokens，他可以实现自动调用同一仓库，实现提交代码

并且会使用今日的日期来作为构建产物上传到的提交信息

实现#

你只需要在你的仓库中心间一份工作流配置文件，就可以实现自动构建 Fuwari 博客了。

路径：.github/workflows/main.yml

代码：

1
name: 构建并上传到“dist”分支
2

3
on:
4
  push:
5
    branches:
6
      - main
7

8
permissions:
9
  contents: write
10

11
jobs:
12
  build:
13
    runs-on: ubuntu-latest
14

15
    steps:
16
      - name: 检查源码
17
        uses: actions/checkout@v4
18

19
      - name: 配置Node.js
20
        uses: actions/setup-node@v4
21
        with:
22
          node-version: 20
23

24
      - name: 安装PNPM
25
        run: |
26
          corepack enable
27
          corepack prepare pnpm@latest --activate
28
          pnpm --version
29

30
      - name: 安装依赖
31
        run: pnpm install
32

33
      - name: 构建
34
        run: pnpm build
35

36
      - name: 获取今日日期
37
        run: echo "DATE=$(date +'%Y-%m-%d')" >> $GITHUB_ENV
38

39
      - name: 上传到“dist”分支
40
        uses: peaceiris/actions-gh-pages@v4
41
        with:
42
          github_token: ${{ secrets.GITHUB_TOKEN }}
43
          publish_dir: ./dist
44
          publish_branch: dist
45
          commit_message: "build: site update ${{ env.DATE }}"
46
          force_orphan: true