AAsteriadne

website

Astro Docs

所属分类：开发者在线工具箱

Astro 网站框架的官方指南、配置参考与内容集合文档。

代码文档

Astro Docs 是 Astro 网站框架的官方文档站，分为 Tutorial、Guide、Reference 和 Ecosystem 四个部分。开发者可以先按教程完成第一个站点，再按主题查阅指南、配置项和 API 参考；想把大量文章、产品资料或其他结构相似的内容交给网站管理时，Guide 中的 Content collections（内容集合）一节专门讲这件事。

Astro Docs：Astro 网站框架的官方指南，含内容集合与配置参考

发布于 2026年10月18日更新于 2026年10月29日

首页的入口与起点

首页的副标题写明，文档提供 guides、resources 和 API references（指南、资料与 API 参考）。Install Astro 按钮和一条 npm create astro@latest 命令用于开始新项目，Take a guided tour 则指向 Build a Blog Tutorial（博客教程）。

首页列出的起始模板包括博客、作品集、文档、落地页、SaaS、营销页和电商站等类型。截至 2026 年 10 月，首页顶部横幅提示 Astro v7 已经发布，并链接到升级说明。

Astro Docs 首页截图，顶部横幅为 Astro v7 is here!，左侧为 Tutorial、Guide、Reference、Ecosystem 与侧边目录，正文标题为 Astro Docs，下方有 Install Astro 按钮

截图与截至 2026 年 10 月的首页一致，顶部横幅、Install Astro 按钮和侧边目录的分组相同。

侧边目录的分组

Guide 的侧边目录按学习顺序分组，依次为 Welcome, world!、Start a new project（安装、项目结构、开发与构建）、Configuration（配置概览、编辑器设置、TypeScript、环境变量、集成、Build with AI 等）、Routing and navigation（页面、路由、端点、中间件等）和 Build your UI（组件、布局、样式、字体等）。Add content to your site 分组包含 Markdown、Content collections、Images 和 Data fetching。

语言菜单列出 English、Deutsch、Español、日本語 和简体中文等多种语言。

内容集合：把成批内容组织成可查询的数据

Content collections 页面（页面标注为 astro@2.0.0 新增）说明，内容集合是一组结构相同的数据。数据可以存放在本地，例如一个 Markdown 文件夹或一个 JSON 文件，也可以从数据库、CMS 或 API 获取，集合中的每一条数据称为 entry。页面给出的示例目录是 src 下的 newsletter 集合（含 week-1.md 等文件），以及只有一个 authors.json 的 author 集合。

Astro Docs 内容集合页面截图，左侧为侧边目录，右侧为页面目录，正文给出 src 目录下 newsletter 与 authors 两个集合的示例文件结构

截图为 Content collections 页面的上半部分，与截至 2026 年 10 月的页面内容一致。示例结构中的文件名是页面给出的示意，不是某个真实项目。

页面的目录列出了完整的学习路径：构建时集合的定义（glob() 与 file() 加载器，以及自定义加载器）、用 Zod 定义集合的数据类型（schema）、定义集合之间的引用、在模板中查询与渲染正文、筛选查询结果、生成路由（静态输出和按需渲染两种方式）。页面后半部分介绍 live content collections（实时内容集合），包括创建 live loader、为实时集合使用 Zod schema、读取与缓存实时数据。页末还有在编辑器中使用 JSON Schema 文件的说明。

适合哪些读者

这份文档适合正在用 Astro 搭建内容网站的开发者。如果要管理的是一批结构相近的文章、资料或产品说明，可以重点阅读内容集合一节，再结合 Configuration 中的 TypeScript 与编辑器设置。只想先跑通一个站点的读者，则可以从 Start a new project 分组开始。