# Astro

> 分类：`libs/frameworks/` · 档位：**评估** · 更新时间：2026-11-17

## 1. 基本信息

| 项 | 内容 |
|---|---|
| 当前版本 | 当前主版本（见官方 releases） |
| License | MIT |
| 维护方 | Astro Technology Company + 社区 |
| 仓库 / 文档 | https://github.com/withastro/astro · https://docs.astro.build |
| 最近 release | 见官方 releases |

## 2. 一句话定位

面向内容站的元框架：默认输出零 JS 的静态 HTML，需要交互的地方用"岛屿"局部水合，可混用 React / Vue / Svelte 组件。
它不是 SPA 框架，复杂后台与强交互应用不是它的主场。

## 3. 体积

| 引入方式 | min | gzip |
|---|---|---|
| 默认静态页 | 0 KB 运行时 | 只有页面自身 HTML/CSS |
| 加一个交互岛屿 | 视组件框架而定 | React 岛屿约 45 KB 级 |
| 构建工具 | 开发依赖 | 不计入产物 |

## 4. 核心 API

```astro
---
// 组件脚本在构建时执行
const items = await fetch('https://api.example.com/list').then(r => r.json());
---
<ul>
  {items.map(i => <li>{i.title}</li>)}
</ul>
<Counter client:visible />
```

```bash
npm create astro@latest
npm run build   # 输出 dist/ 纯静态
```

## 5. 适用 / 不适用

- **适用**：官网、文档、博客、营销页、内容为主的电商前台。
- **不适用**：重交互后台、实时协作类应用（用 Next/Nuxt 或纯 SPA 更顺）。

## 6. 硬缺口与已知坑

- 岛屿水合指令（`client:load` / `client:visible` 等）选错会带来不必要的 JS 或不响应。
- 需要 SSR / 动态接口时要装对应 adapter，部署形态随之变化。
- 多框架混用灵活但会增加理解与依赖成本。
- 生态插件质量参差，复杂集成仍要自己兜底。

## 7. 受限环境可用性

| 环境 | 结论 | 说明 |
|---|---|---|
| 无构建 | 不可用 | 必须走构建 |
| 静态输出 | 可用 | `dist/` 可直接托管 |
| SSR | 需 adapter | 按平台选择 |
| 客户端重渲染 | 与框架模型冲突 | 岛屿模式不鼓励整页重渲染 |

## 8. 稳定性评分

| 维度 | 评分 | 依据 |
|---|---|---|
| 维护活跃度 | 5 | 迭代快、社区活跃 |
| 版本与破坏性变更 | 3 | 大版本升级偶有迁移成本 |
| 采用度 | 4 | 内容站采用度高 |
| 体积与按需 | 5 | 默认零 JS，岛屿按需 |
| 生态兼容 | 4 | 可混用主流组件框架 |
| License | 5 | MIT |

## 9. 替代品对比

| 库 | 优势 | 劣势 | 何时选它 |
|---|---|---|---|
| Next.js | 生态最大、SSR/RSC 完整 | 默认 JS 体积大 | 应用型项目 |
| Nuxt | Vue 生态完整 | 与 Vue 绑定 | Vue 团队 |
| Eleventy | 极简、纯模板 | 交互要自己接 | 纯静态博客 |
| VitePress | 文档场景开箱即用 | 面向文档，不是通用框架 | 技术文档站 |
