静态博客部署到 Cloudflare Pages 很方便，但真正影响体验的往往是一些小细节：构建命令、输出目录、域名绑定、缓存策略。

这些事情不复杂，但提前整理好，可以让后续更新省心很多。

构建命令和输出目录

VuePress 项目通常需要把构建命令设为 npm run docs:build，输出目录指向 src/.vuepress/dist。如果项目不在仓库根目录，还要记得设置根目录。

这些配置一旦错了，最常见的现象是部署成功但页面空白，或者访问路径不对。

自定义域名