Starlight：基于 Astro 的文档网站框架，8.7K Star

Starlight：基于 Astro 的文档网站框架，8.7K Star

Starlight 是 Astro 团队推出的文档网站框架，GitHub 上已有 8,794 个 Star。

如果你用 Astro 建过站，应该知道它擅长内容型网站。Starlight 把这件事做得更专——不用从零搭导航、搜索、侧边栏这些东西，开箱即用。

它解决什么问题

文档站说难不难，但要做得好用，需要不少功夫：目录结构怎么组织、搜索怎么实现、暗色模式要不要、多语言怎么处理、移动端适配怎么做。

这些问题每个项目都来一遍，就是浪费。

Starlight 把这套东西打包好，你只管写 Markdown 内容，其他交给它。

核心能力

Starlight 提供了一套完整的文档站基础设施：

• 自动生成导航和侧边栏，从文件目录结构推断
• 内置全文搜索，不需要对接第三方服务
• 支持多语言文档，按目录组织翻译文件
• 自动处理暗色/亮色模式切换
• 生成站点地图和 RSS
• SEO 标签自动生成

所有页面都走 Astro 的编译管线，首屏加载速度很快。

使用方式

Starlight 是一个 Astro 集成，安装方式：

# 创建新项目npmcreate astro@latest ----templatestarlight# 或者加到现有 Astro 项目npminstall@astrojs/starlight

配置文件里声明目录结构，然后往src/content/docs/下放 Markdown 文件就行。

适合谁用

技术团队的文档站、开源项目文档、API 文档、内部知识库——只要是内容为主的站点，Starlight 都能用。

对比 Docusaurus 和 VitePress，Starlight 的优势在于 Astro 生态：部分 hydration、岛屿架构、多种 UI 框架混用。如果你已经在用 Astro，选它几乎没有额外学习成本。

项目信息

MIT 协议开源，社区活跃，有问题可以去 Astro Discord 的#starlight频道交流。

IT 协议开源，社区活跃，有问题可以去 Astro Discord 的#starlight频道交流。