私有博客搭建指南：Hugo + GitHub + Vercel

Wed, 16 Sep 2026 08:30:00 +0800

我想搭建一个私有博客，本地编辑 Markdown，git 提交后自动更新，代码托管到 GitHub + Vercel。

结论先行：推荐 Hugo —— 它单文件安装、零依赖、构建极快，和你"本地 Markdown + git 推送 + 自动部署"的工作流匹配度最高；如果想要更现代的前端定制能力，备选 Astro。

一、为什么选 Hugo（对比）

维度	Hugo（推荐）	Astro（备选）	Hexo
底层	Go，单二进制，无运行时依赖	Node.js 前端框架	Node.js
构建速度	最快：实测 1 万页约 2.95 秒	快，构建期零 JS 输出	较慢：1000 页约 45 秒
上手门槛	低（装一个程序即可）	中（需前端基础）	低，中文资料最多
主题生态	丰富（PaperMod、Stack、DoIt 等）	增长快	丰富但维护热度下降
适合人群	文章多、技术向、追求极简工作流	想深度定制 UI 的前端开发者	新手、纯中文生态偏好

选 Hugo 的核心理由：你的需求是"本地写 Markdown → git 提交 → 自动更新"，Hugo 不需要任何构建环境（不用装 Node），Vercel 上一条命令搞定，日常维护成本最低。

二、整体架构

每次 git push 后，Vercel 自动拉取代码、执行构建、发布到 CDN，全程无需手动上传：

本地编辑 Markdown → git commit / push → GitHub 仓库
 │
 ▼
 Vercel 自动拉取并构建（hugo）
 │
 ▼
 发布到 CDN → https://xxx.vercel.app

三、详细搭建步骤（Hugo 主线）

第 1 步：本地安装 Hugo

Windows：winget install Hugo.Hugo.Extended（或去 GitHub Releases 下载 hugo_extended_*_windows-amd64.zip，解压后把目录加进 PATH）
macOS：brew install hugo
验证：hugo version

第 2 步：初始化站点并选主题

hugo new site myblog # 创建站点骨架
cd myblog
git clone https://github.com/adityatelange/hugo-PaperMod themes/PaperMod # 下载主题（以 PaperMod 为例）

编辑 hugo.toml，启用主题并写基本信息：

baseURL = "https://你的vercel域名.vercel.app/" # 部署拿到域名后回填，也可先留默认
languageCode = "zh-cn"
title = "我的博客"
theme = "PaperMod"

第 3 步：写第一篇文章并本地预览

hugo new posts/hello.md # 创建文章，正文是标准 Markdown
hugo server -D # 本地预览，浏览器打开 http://localhost:1313

文章头部有 front matter，记得把 draft: true 删掉或改 false，否则发布时不会输出。

第 4 步：Git 初始化并推送 GitHub

echo "/public/" > .gitignore # 构建产物不入库
git init
git add . && git commit -m "init blog"
git branch -M main
git remote add origin https://github.com/你的用户名/仓库名.git
git push -u origin main

GitHub 上先建一个空仓库（不勾选 README，避免和本地冲突）；仓库建 private 也没问题，Vercel 授权后照样能部署。

第 5 步：接入 Vercel 自动部署

打开 vercel.com，用 GitHub 账号登录（授权时会要求安装 Vercel GitHub App，勾选允许访问你的博客仓库）
Add New → Project → Import 选刚才的仓库
Framework Preset 选 Hugo（Vercel 会自动识别）；确认 Build Command 为 hugo、Output Directory 为 public
点 Deploy，一两分钟后访问生成的 https://xxx.vercel.app 即可

之后每次 git push 都会自动触发重新构建，只需导入一次。

第 6 步：日常更新流程（之后每天都一样）

hugo new posts/新文章.md # 写 Markdown
git add . && git commit -m "add: 新文章" && git push

推完等 1～2 分钟，Vercel 自动部署完成，这就是"git 提交后自动更新"的全部日常。

四、几点提醒

“私有博客"的含义：Vercel 部署出的站点是公开可访问的（知道链接即可访问）。如果指"私人内容”，需要额外加访问控制（如部署后前端加密码页或 Basic Auth）；如果只是"个人专属的公开博客"，现在的方案就够了。
国内访问：Vercel 默认域名在国内一般可访问但速度一般，GitHub push 偶有波动。介意的话可以：绑定自己的域名（Vercel → Settings → Domains），或改用 Cloudflare Pages（步骤几乎一致）。
想选 Astro：安装 Node.js 后 npm create astro@latest，用官方博客模板（含 Content Collections），Vercel 会识别 Astro 框架，其余流程完全相同。

Vercel on 我的博客