![]()
作者 | 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)載。
特別聲明:以上內(nèi)容(如有圖片或視頻亦包括在內(nèi))為自媒體平臺(tái)“網(wǎng)易號(hào)”用戶(hù)上傳并發(fā)布,本平臺(tái)僅提供信息存儲(chǔ)服務(wù)。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.