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

作者 | Daniel Curtis

譯者 | 明知山

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

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

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

});

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

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

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

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

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

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

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

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

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

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

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