目录

• 架构概述
• 常见坑点
• 配置步骤
• Workflow 文件
• 故障排查

架构概述

部署架构

• 源码仓库 A：存放 Hugo 博客源码、主题、配置文件
• 静态仓库 B（如 hex2rgb.github.io）：存放打包后的静态页面

核心流程

SSH 密钥对（本地生成）
    ↓
公钥 → 部署到【静态仓库 B】Deploy Keys
文章底部-如图【1】
私钥 → 加密存入【源码仓库 A】GitHub Secrets
文章底部-如图【2】
    ↓
Actions 执行：安装 Hugo → 打包源码 → 生成 public → 用私钥推送

常见坑点

Job 隔离问题

不同 job 环境完全隔离，执行完毕立即销毁。如果把 build 和 deploy 分为两个 job，打包生成的 public 目录会丢失。