Y. YINCHAOJI / 思考 · 构建 · 记录
← 所有文章
Web 开发 / 2026.11.01 / 约 2 分钟

Astro 与 Workers:一个轻量博客的组成

从 Markdown 到静态页面,再到边缘网络,理解这个博客的构建与交付过程。

V1 示例文章。完整操作步骤见项目中的 DEPLOY.md。

内容先行

文章保存在 src/content/blog/。Astro 在构建时读取 Markdown 和 MDX,将它们转为 HTML。分类页、标签页和 RSS 也在这一步生成。

npm ci
npm run verify
npm run preview:workers

静态页面如何运行在 Workers 上

V1 使用 Workers Static Assets 托管 dist/。文章在构建时就准备好了,因此无需为每次阅读动态生成页面。

层次 职责
Markdown / MDX 保存内容
Astro 生成页面与订阅源
Workers Static Assets 分发构建产物
GitHub Actions 校验与可选部署

保持配置清晰

{
  "name": "yinchaoji-blog",
  "assets": { "directory": "./dist" }
}

这里仅展示核心配置。完整配置还包含 URL 规范化与 404 行为。

为下一步留出空间

如果未来需要登录、评论后端或按请求生成页面,再引入 Cloudflare 适配器与相应的存储绑定。当前版本先把阅读体验和写作流程做好。

← 继续阅读其他文章