Rspress 2.0 發布：AI 原生文檔、更快啟動速度與全新設計主題

作者 | Daniel Curtis

譯者 | 明知山

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。啟用該功能僅需一行配置：

});

構建性能通過兩項默認啟用的功能得到顯著提升：懶編譯與持久化緩存。借助懶編譯，開發過程中僅在訪問頁面時才進行編譯；根據 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 集成，用于組件庫文檔工作流。

https://www.infoq.com/news/2026/03/rspress-docs-2-release/

聲明：本文為 InfoQ 翻譯，未經許可禁止轉載。