Astro:为内容型网站而生的 Web 框架

默认零 JavaScript、按需“点亮”交互的内容网站框架

前端 / 静态站点与内容网站6.4 万
Astro
协议
MIT
Star 数
约 6.4 万(64,011)
最新版本
7.4.12(2026-11-13 发布)
运行环境
Node.js 22.23.4 及以上

Star 数、版本等数据截至 2026 年 11 月。 技术栈:TypeScriptViteNode.js

定位

一句话:默认零 JavaScript、按需"点亮"交互的内容网站框架。

Astro 先在构建时(或服务器上)把页面渲染成纯 HTML,只有标记为需要交互的组件才加载 JavaScript,这就是它的"群岛架构"(Islands)。页面因此天生又快又轻。它不绑定 UI 库:同一个站点里可以混用 React、Vue、Svelte、Solid 等组件。

仓库链接

适用场景

  • 适合:官网与营销页、博客、文档站、作品集、设计系统站点、电商的展示页面等以内容为主、追求加载速度和 SEO 的网站。
  • 也能做:借助服务器渲染(SSR)与各平台适配器,做带登录、接口的动态站点。
  • 不太适合:交互极重、整页都是状态的单页应用(如在线编辑器、复杂后台),这类更适合 Next.js、SvelteKit 等应用型框架。

上手示例

创建项目并启动开发服务器:

Bash
npm create astro@latest my-site
cd my-site
npm run dev

一个最小页面 src/pages/index.astro:上面 --- 之间是只在构建时运行的代码,下面是模板。

Astro
---
const frameworks = ["React", "Vue", "Svelte"];
const today = new Date().toLocaleDateString("zh-CN");
---
<html lang="zh-CN">
  <head><title>你好,Astro</title></head>
  <body>
    <h1>你好,Astro!今天是 {today}</h1>
    <ul>
      {frameworks.map((name) => <li>可以混用 {name} 组件</li>)}
    </ul>
  </body>
</html>

src/pages/ 下的文件自动成为路由(index.astro 就是首页),npm run build 输出纯静态 HTML。

在线试一试(浏览器里直接运行,无需安装):

官方基础示例在 StackBlitz 中打开的样子
官方基础示例在 StackBlitz 中打开的样子

优点

  • 快:默认不往页面里塞 JavaScript,首屏加载和 Lighthouse 分数通常都很好。
  • 不绑定 UI 库:React、Vue、Svelte、Solid 等组件可以在同一项目里混用,团队已有组件能直接复用。
  • 内容能力强:原生支持 Markdown / MDX,内容集合(Content Collections)带类型校验,很适合博客和文档。
  • 部署灵活:既能输出纯静态站点,也能通过适配器部署到 Node、Vercel、Netlify、Cloudflare 等做服务器渲染。
  • 生态成熟:官方集成与主题丰富,有专门的文档站方案 Starlight。

缺点

  • 不适合重交互应用:整页高度交互的单页应用用 Astro 反而绕,需要大量"群岛"拼接。
  • 多一层概念:.astro 语法、client:* 指令、群岛的加载时机,需要额外学习。
  • 对运行环境要求新:当前版本要求 Node.js 22.23.4 及以上,老项目、老环境要先升级。
  • 跨群岛共享状态麻烦:不同组件群岛之间共享状态要借助额外的库(如 nanostores)。

同类对比

框架更适合
Astro内容为主、追求速度的网站:官网、博客、文档站
Next.jsReact 技术栈的全栈应用,交互和数据都重的产品
SvelteKit想要轻量运行时、写法简洁的全栈应用

作品展示

以下站点均选自 Astro 官方作品展示页,更多案例见上面"仓库链接"一节里的官方作品展示。