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

作者 | Daniel Curtis

譯者 | 明知山

Rspress 是一款基于 Rsbuild、專為開發(fā)者文檔打造的靜態(tài)站點生成器，現(xiàn)已正式發(fā)布 2.0 版本，帶來了主題設(shè)計、構(gòu)建性能、AI 集成及開發(fā)者體驗等方面的全面升級。該版本于 2026 年 1 月 30 日發(fā)布，在 1.x 版本周期內(nèi)歷經(jīng) 144 次迭代，共有 125 位開發(fā)者參與貢獻(xiàn)。

Rspress 2.0 引入了由設(shè)計師 Zovn Wei 重新設(shè)計的默認(rèn)主題，提供四級 自定義 能力。開發(fā)者可通過調(diào)整 CSS 變量快速定制主題，借助 BEM 類名精確覆蓋樣式，通過 ESM 導(dǎo)出替換單個組件，或完全彈出組件以獲得完整控制權(quán)。采用 BEM 方案是經(jīng)過深思熟慮的選擇，旨在與特定 CSS 框架解耦，讓團(tuán)隊可自由使用 Tailwind、Less 或 Sass，無需擔(dān)心版本沖突。

其中一項更具前瞻性的新增功能是靜態(tài)站點生成 Markdown（SSG?MD）特性。這是一種全新的渲染模式，可從文檔站點生成 Markdown 文件與 llms.txt 輸出。不同于將 HTML 轉(zhuǎn)換回 Markdown（效果通常不佳），SSG?MD 通過 React 虛擬 DOM 渲染內(nèi)容，生成適合 AI 智能體使用的高質(zhì)量 Markdown。啟用該功能僅需一行配置：

});

構(gòu)建性能通過兩項默認(rèn)啟用的功能得到顯著提升：懶編譯與持久化緩存。借助懶編譯，開發(fā)過程中僅在訪問頁面時才進(jìn)行編譯；根據(jù) Rspress 團(tuán)隊在 GitHub 上公布的基準(zhǔn)測試，冷啟動時間從數(shù)秒縮短至最低 50 毫秒。路由預(yù)加載策略會在鏈接懸停時觸發(fā)編譯，確保導(dǎo)航流暢。持久化緩存可復(fù)用歷史編譯結(jié)果，將后續(xù)構(gòu)建速度提升 30% 至 60%。

代碼高亮已從 Prism 默認(rèn)切換為 Shiki，語法高亮在構(gòu)建時執(zhí)行，而非運(yùn)行時。這帶來了與 VS Code 一致、基于 TextMate 語法的精準(zhǔn)高亮，支持按需加載語言且無運(yùn)行時開銷，同時支持自定義轉(zhuǎn)換器（例如用于內(nèi)聯(lián)類型提示的 twoslash）。

本次發(fā)布還對包結(jié)構(gòu)進(jìn)行了整合，包括 rspress、@rspress/runtime、@rspress/shared 和 @rspress/theme-default 在內(nèi)的多個包已合并為單一的 @rspress/core 包。

新版本發(fā)布后收獲了積極反饋，一位用戶在 r/Rspack 子版塊 評論道：

很高興看到這類工具的出現(xiàn)！祝賀發(fā)布！

用于追蹤重大變更的 GitHub 討論帖 收獲了積極互動，共 26 條評論、19 條回復(fù)，內(nèi)容涵蓋從 Shiki 配置到 React Router 兼容性等遷移細(xì)節(jié)。

與 Docusaurus 和 VitePress 等同類工具相比，Rspress 的核心差異化優(yōu)勢在于基于 Rspack 的構(gòu)建速度及其 AI 原生能力。Docusaurus 官方也 認(rèn)可 Rspress 憑借現(xiàn)代化的底層架構(gòu)實現(xiàn)了更快的站點構(gòu)建，同時也指出自身在成熟度與社區(qū)規(guī)模上的優(yōu)勢。VitePress 仍是 Vue 項目的首選，而 Rspress 則主打 React 生態(tài)。

Rspress 2.0 要求 Node.js 20 及以上版本，支持 React 18 和 19?；?Rust 的 MDX 解析器（@rspress/mdx-rs）已被棄用，轉(zhuǎn)而采用 JavaScript MDX 解析器，以犧牲部分原始編譯速度為代價，換取與 Shiki、自定義 remark 和 rehype 插件等工具更好的生態(tài)兼容性。從 1.x 升級的團(tuán)隊可參考詳細(xì)的 遷移指南。

Rspress 是一款基于 Rsbuild 和 Rspack 的開源靜態(tài)站點生成器，屬于 Rstack JavaScript 工具鏈的一部分。它專為構(gòu)建支持 MDX、約定式路由與組件庫預(yù)覽的文檔站點設(shè)計，可與 Rslib 集成，用于組件庫文檔工作流。

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

聲明：本文為 InfoQ 翻譯，未經(jīng)許可禁止轉(zhuǎn)載。