- 协议
- 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 等组件。
仓库链接
- 仓库:https://github.com/withastro/astro
- 官网:https://astro.build/
- 文档:https://docs.astro.build/zh-cn/getting-started/
- 官方作品展示:https://astro.build/showcase/
适用场景
- 适合:官网与营销页、博客、文档站、作品集、设计系统站点、电商的展示页面等以内容为主、追求加载速度和 SEO 的网站。
- 也能做:借助服务器渲染(SSR)与各平台适配器,做带登录、接口的动态站点。
- 不太适合:交互极重、整页都是状态的单页应用(如在线编辑器、复杂后台),这类更适合 Next.js、SvelteKit 等应用型框架。
上手示例
创建项目并启动开发服务器:
npm create astro@latest my-site
cd my-site
npm run dev一个最小页面 src/pages/index.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。
在线试一试(浏览器里直接运行,无需安装):
- 官方基础示例(basics):https://stackblitz.com/github/withastro/astro/tree/latest/examples/basics?file=src%2Fpages%2Findex.astro
- 官方博客示例(blog):https://stackblitz.com/github/withastro/astro/tree/latest/examples/blog?file=src%2Fpages%2Findex.astro

优点
- 快:默认不往页面里塞 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.js | React 技术栈的全栈应用,交互和数据都重的产品 |
| SvelteKit | 想要轻量运行时、写法简洁的全栈应用 |
作品展示
以下站点均选自 Astro 官方作品展示页,更多案例见上面"仓库链接"一节里的官方作品展示。
作品展示微软 Fluent 2 设计系统的官方站点,深色视觉、3D 主视觉与成体系的组件文档,展示了 Astro 做大型设计系统站的能力。
作品展示Visa 的产品设计系统(VPDS),覆盖设计规范、组件与数据可视化,导航层级多、内容量大。
作品展示Cloudflare 全部产品的开发者文档,页面数量庞大,是 Astro 做大规模文档站的代表案例。
作品展示英国《卫报》工程团队的介绍站,排版讲究、图文结合,展示了 Astro 做品牌与招聘站的效果。
在线运行官方示例项目,在浏览器里直接打开运行、修改代码,不用在本地安装。
在线运行官方示例项目,在浏览器里直接打开运行、修改代码,不用在本地安装。
