Welcome to Astro + Cloudflare Pages

发布于 2026年02月13日 13:16

这是你的第一篇文章。你可以在 src/content/blog/ 中继续添加 Markdown 或 MDX 文件。

为什么这个组合适合个人博客

构建输出是纯静态文件，部署和回滚都很稳。
Cloudflare Pages 免费额度对个人博客基本够用。
Astro 对内容网站性能很友好。

把博客托管到 Cloudflare Pages 后，每次推送都可以自动触发构建。

推荐配置

Build command: npm run build
Output directory: dist
Node version: 20

线上维护建议

主分支仅保留可发布内容
重要改动先走预览环境
保留关键版本 tag，方便回滚

Astro 的 Content Collections 能把内容结构类型化，避免前置数据缺失导致的线上报错。

关键实践

在 src/content/config.ts 定义 schema
对 date 使用 z.coerce.date()
用 draft 字段控制发布

收益

构建阶段就能发现 frontmatter 错误
页面中读取字段时有类型提示
后续扩展字段更容易管理

常用命令

调试(Local)

npm run dev

调试(Local + Network)

npx astro dev --host

 astro  v5.17.2 ready in 206 ms

┃ Local    http://localhost:4321/
┃ Network  http://192.168.2.31:4321/

下一步可选增强

接入评论系统（Giscus: ）
接入站内搜索（Pagefind）
增加文章封面图和社交分享图

参考资料

评论互动