Astro
概述
Astro 是一个用于构建内容驱动型网站的 Web 框架,默认情况下不发送任何 JavaScript。其岛屿架构仅水合交互组件,在支持 React、Vue、Svelte 或任何需要交互性的 UI 框架的同时,可获得卓越的 Lighthouse 评分。
指令
- 创建页面时,在
src/pages/中使用基于文件的路由,文件格式为.astro、.md或.mdx,并将共享结构组织在src/layouts/中。 - 添加交互性时,对框架组件使用客户端指令:优先使用
client:visible或client:idle,而不是client:load,因为大多数组件不需要立即水合。 - 管理内容时,在
src/content/中使用严格的 Zod 模式定义内容集合,使用defineCollection(),并通过getCollection()和getEntry()进行查询。 - 选择渲染模式时,对于营销和内容页面默认使用静态(SSG),对于动态页面使用
output: "server",或使用混合渲染,在每页通过export const prerender = false进行控制。 - 优化图像时,请使用
astro:assets中的<Image>组件进行自动格式转换(WebP/AVIF)、调整大小和延迟加载,而不是使用原始<img>标签。 - 添加页面过渡时,启用
<ViewTransitions />实现类似 SPA 的导航,而无需发送客户端路由器。 - 集成 UI 框架时,安装相应的集成(
@astrojs/react、@astrojs/vue、@astrojs/svelte),并使用 Astro 组件处理静态内容,仅在需要交互性时才使用框架组件。
示例
示例 1:使用内容集合构建博客
用户请求:"创建一个具有类型安全 Markdown 内容的 Astro 博客"
操作:
- 使用 Zod 模式为博客内容集合定义 frontmatter(标题、日期、标签、作者)
- 创建动态路由
src/pages/blog/[slug].astro,并使用getStaticPaths() - 构建博客索引页面,通过
getCollection("blog")查询并排序 - 添加包含 SEO 元标签、导航和视图过渡的布局
**输出:**一个静态生成的博客,具有经过验证的内容、干净的 URL 和流畅的页面过渡。
示例 2:向静态站点添加交互组件
用户请求:"向我的 Astro 文档站点添加一个 React 搜索组件"
操作:
- 安装
@astrojs/react集成 - 创建带有状态和事件处理的 React 搜索组件
- 使用
client:idle指令将组件添加到页面 - 从 Astro 页面的 frontmatter 中将静态数据作为 props 传递
**输出:**一个完全静态的文档站点,但包含一个交互式搜索岛屿。
指南
- 使用 Astro 组件(
.astro)处理静态内容;仅在需要交互性时使用 React/Vue/Svelte。 - 对于水合指令,默认使用
client:visible或client:idle而不是client:load。 - 使用严格的 Zod 模式定义内容集合,以便在构建时捕获内容错误。
- 使用
astro:assets的<Image>组件而非原始<img>标签进行自动优化。 - 保持布局精简,包含共享的
<head>、导航和页脚;将页面特定内容放在各个页面中。 - 使用混合渲染:营销页面使用静态渲染,仅对个性化或动态页面使用 SSR。
- 启用视图过渡以实现类似 SPA 的导航,而无需发送路由器。