用 VuePress + Cloudflare Pages 搭一个「推上去就上线」的博客

前后折腾不到半小时，博客就有了一个能自动发布的完整流水线。记录一下关键决策，省得下次重来。

为什么是这套组合

需求	方案
写起来快	Markdown 优先，目录即路由
好看且不折腾	vuepress-theme-hope，博客/搜索/暗色模式自带
源码不公开	GitHub 私有仓库
部署零维护	Cloudflare Pages，绑定 Git 后自动构建
免费	Pages 免费额度对个人博客绰绰有余

目录结构

blog/
├── package.json
└── src/
    ├── .vuepress/
    │   ├── config.js      # 站点配置
    │   ├── theme.js       # 主题配置
    │   ├── navbar.js      # 导航栏
    │   ├── sidebar.js     # 侧边栏
    │   └── public/        # 静态资源（logo / favicon）
    ├── README.md          # 首页
    ├── about.md
    └── posts/             # 文章都放这里

Cloudflare Pages 的三行配置

Framework preset : None
Build command    : npm run docs:build
Build output     : src/.vuepress/dist

再加一个环境变量 NODE_VERSION = 22（VuePress 2 要求 Node ≥ 18，写死版本能避免 CF 默认版本太老导致构建失败）。

私有仓库能不能用

能。Cloudflare 连 GitHub 时授权一次即可读取私有仓库，站点本身照常公开访问，只是源码不露出来。

注意：如果你的仓库属于组织，授权时需要组织管理员批准 Cloudflare 的 GitHub App。

小结

写作的摩擦力降到「写完 push」，这件事本身就会让人更愿意写。