EdgeEver 笔记 -> GitHub -> Vercel 博客自动化流水线与构建排坑全指南
本文档完整记录从 EdgeEver 笔记打标、经过 Blog MCP 推送 GitHub、再到 Vercel 自动构建 Hugo 博客并绑定 Cloudflare 自定义域名的全流程。重点复盘部署过程中因为 Framework 预设、环境变量版本号、Extended 依赖及快照机制导致的多次构建失败根因与彻底解决方案。 一、 整体技术架构与流转链路 [EdgeEver 笔记] (打标 blog / 博客 + 毫秒级锁定原始时间戳) │ ▼ (Blog MCP / Cloudflare Worker: publish_post) [GitHub 仓库] (kyaring/myblog -> content/posts/*.md) │ ▼ (Webhook 自动触发推送事件) [Vercel CI/CD] (注入 HUGO_VERSION 环境变量 -> Hugo Extended 编译静态站点 public/) │ ▼ (CNAME 记录 DNS only) [Cloudflare DNS] (blog.555586.xyz -> Vercel CDN 自动化 SSL) 源头管理:在 EdgeEver 中编写笔记,添加 blog 标签; 发布调度:Blog MCP 将笔记格式化为带 FrontMatter(title, date, tags, slug)的标准 Markdown,调用 GitHub API 提交并推送到仓库; 自动化部署:Vercel 监听 GitHub main 分支变动,自动拉取并根据环境变量指定版本运行 Hugo Extended 生成 HTML; 终端访问:Cloudflare DNS 解析至 Vercel,提供全球加速与自动化 HTTPS。 二、 核心部署踩坑复盘(为什么错了好几次?哪里出了错?) 在本次实际部署中,由于对 Vercel 构建镜像的预装机制、版本回退策略以及主题对 SCSS 的硬性依赖认识不足,导致连续构建失败、反复重试。以下为具体技术细节还原:...