Rspress 是一款基于 Rsbuild、专为开发者文档打造的静态站点生成器，现已正式发布 2.0 版本，带来了主题设计、构建性能、AI 集成及开发者体验等方面的全面升级。该版本于 2026 年 1 月 30 日发布，在 1.x 版本周期内历经 144 次迭代，共有 125 位开发者参与贡献。
Rspress 2.0 引入了由设计师 Zovn Wei 重新设计的默认主题，提供四级自定义能力。开发者可通过调整 CSS 变量快速定制主题，借助 BEM 类名精确覆盖样式，通过 ESM 导出替换单个组件，或完全弹出组件以获得完整控制权。采用 BEM 方案是经过深思熟虑的选择，旨在与特定 CSS 框架解耦，让团队可自由使用 Tailwind、Less 或 Sass，无需担心版本冲突。
其中一项更具前瞻性的新增功能是静态站点生成 Markdown（SSG‑MD）特性。这是一种全新的渲染模式，可从文档站点生成 Markdown 文件与 llms.txt 输出。不同于将 HTML 转换回 Markdown（效果通常不佳），SSG‑MD 通过 React 虚拟 DOM 渲染内容，生成适合 AI 智能体使用的高质量 Markdown。启用该功能仅需一行配置：
import { defineConfig } from '@rspress/core';
export default defineConfig({
llms: true,
});
构建性能通过两项默认启用的功能得到显著提升：懒编译与持久化缓存。借助懒编译，开发过程中仅在访问页面时才进行编译；根据 Rspress 团队在 GitHub 上公布的基准测试，冷启动时间从数秒缩短至最低 50 毫秒。路由预加载策略会在链接悬停时触发编译，确保导航流畅。持久化缓存可复用历史编译结果，将后续构建速度提升 30% 至 60%。
代码高亮已从 Prism 默认切换为 Shiki，语法高亮在构建时执行，而非运行时。这带来了与 VS Code 一致、基于 TextMate 语法的精准高亮，支持按需加载语言且无运行时开销，同时支持自定义转换器（例如用于内联类型提示的 twoslash）。
本次发布还对包结构进行了整合，包括 rspress、@rspress/runtime、@rspress/shared 和 @rspress/theme-default 在内的多个包已合并为单一的 @rspress/core 包。
新版本发布后收获了积极反馈，一位用户在 r/Rspack 子版块评论道：
很高兴看到这类工具的出现！祝贺发布！
用于追踪重大变更的 GitHub 讨论帖收获了积极互动，共 26 条评论、19 条回复，内容涵盖从 Shiki 配置到 React Router 兼容性等迁移细节。
与 Docusaurus 和 VitePress 等同类工具相比，Rspress 的核心差异化优势在于基于 Rspack 的构建速度及其 AI 原生能力。Docusaurus 官方也认可 Rspress 凭借现代化的底层架构实现了更快的站点构建，同时也指出自身在成熟度与社区规模上的优势。VitePress 仍是 Vue 项目的首选，而 Rspress 则主打 React 生态。
Rspress 2.0 要求 Node.js 20 及以上版本，支持 React 18 和 19。基于 Rust 的 MDX 解析器（@rspress/mdx-rs）已被弃用，转而采用 JavaScript MDX 解析器，以牺牲部分原始编译速度为代价，换取与 Shiki、自定义 remark 和 rehype 插件等工具更好的生态兼容性。从 1.x 升级的团队可参考详细的迁移指南。
Rspress 是一款基于 Rsbuild 和 Rspack 的开源静态站点生成器，属于 Rstack JavaScript 工具链的一部分。它专为构建支持 MDX、约定式路由与组件库预览的文档站点设计，可与 Rslib 集成，用于组件库文档工作流。
原文链接：
