内容集合与 Frontmatter：把写作变成数据

写博客最怕的不是没内容，而是内容写完了，页面却是空的。少一个冒号、日期格式不对、字段名拼错，都可能让文章悄悄消失。

Astro 的内容集合把这类问题从「发布后才发现」提前到了「构建时直接报错」。

Frontmatter 是文章的第一层结构#

title必填string

文章标题。归档、搜索、RSS 和分享卡片都会用到。

published必填date

发布日期，决定归档位置和列表排序。格式必须是 YYYY-MM-DD。

draft可选boolean

false

草稿开关。开启后只在开发环境可见，正式构建会被排除。

tags可选string[]

[]

标签数组，会进入标签聚合页。中文标签会直接作为展示文本。

::::

这些字段看起来简单，但它们共同决定了一篇文章在站点里的位置、可见性和关联关系。

1
title: 你好，新网站
2
published: 2026-10-31
3
description: 第一篇正式文章。
4
tags:
5
  - 随笔
6
  - 建站
7
category: 随笔
8
draft: false

只要 title 和 published 存在，文章就能被识别。其余字段都有默认值，不需要为了「填满模板」而写一堆空字段。

从新建到发布

这套流程的价值在于：写作时只需要关心内容，结构检查交给工具。

一开始我以为分类、标签、系列要分别维护，后来发现它们其实都从文章字段长出来：

文章是唯一的数据源，其他页面都是它的投影。这样做的好处是不会出现「文章改了标签，标签页却没更新」的同步问题。

内容集合最容易被低估的地方，是它把「写作规范」变成了可以执行的代码。规范写在文档里，靠人记住；schema 写在代码里，构建时会替你检查。

对于一个人维护的博客来说，后者的价值更大——因为没有人会替你 review frontmatter。