Rspress 2.0 发布：AI 原生文档、更快启动与全新设计

Rspress，一款基于 Rsbuild、专为构建开发者文档而生的静态站点生成器，现已迎来 2.0 版本的重大更新。这次发布带来了主题设计、构建性能、AI 集成以及开发者体验的全方位升级。该版本于 2026 年 1 月 30 日发布，在 1.x 周期内经历了 144 次迭代，并汇聚了 125 位开发者的贡献。

全新设计主题与深度定制能力

Rspress 2.0 引入了由设计师 Zovn Wei 操刀重新设计的默认主题，并提供了四个层级的自定义能力，让你对文档站点的外观拥有前所未有的控制力。开发者可以通过调整 CSS 变量快速实现主题定制，利用 BEM 类名精准覆盖特定样式，通过 ESM 导出替换单个组件，甚至完全弹出组件以获得完全的控制权。

选择 BEM（Block Element Modifier）方案是经过深思熟虑的，其主要目的是与特定的 前端框架/工程化 CSS 框架解耦。这使得开发团队可以自由选用 Tailwind、Less 或 Sass 等工具，而无需担心潜在的版本冲突问题。

前瞻性 AI 集成：SSG-MD 特性

此次更新最具前瞻性的功能之一是静态站点生成 Markdown（SSG-MD）。这并非简单的 HTML 到 Markdown 的转换（那种方式效果通常不理想），而是一种全新的渲染模式。它通过 React 虚拟 DOM 来渲染内容，从而生成高质量、结构清晰的 Markdown 文件及配套的 llms.txt 输出，专为 AI 智能体使用而优化。

启用这一功能极其简单，只需要在配置中添加一行代码。这对于希望将现有文档快速转化为 AI 可读格式的团队来说，无疑是一个强大的工具。如果你对这种将前沿 AI 能力与 开源实战 项目结合的实践感兴趣，不妨深入探索其实现原理。

import { defineConfig } from '@rspress/core';
export default defineConfig({
  llms: true,
});

构建性能的显著提升

在构建速度方面，Rspress 2.0 通过两项默认启用的功能带来了立竿见影的提升：懒编译与持久化缓存。

• 懒编译：在开发模式下，只有当你访问某个页面时，该页面才会被编译。根据 Rspress 团队在 GitHub 上分享的基准测试，这能将冷启动时间从数秒缩短至最低 50 毫秒。配合路由预加载策略（在鼠标悬停于链接上时触发编译），能够确保页面间导航的流畅体验。
• 持久化缓存：该功能可以复用历史的编译结果，根据官方数据，这能将后续的构建速度提升 30% 至 60%。

代码高亮与包结构优化

代码高亮引擎也从 Prism 默认切换为了 Shiki。这意味着语法高亮将在构建时完成，而不是在运行时。此举带来了与 VS Code 一致的、基于 TextMate 语法的精准高亮效果，支持按需加载语言且无运行时开销，同时还允许使用自定义转换器（例如用于内联类型提示的 twoslash）。

此外，本次发布还对包结构进行了整合。原先分散的 rspress、@rspress/runtime、@rspress/shared 和 @rspress/theme-default 等多个包，现已合并为单一的 @rspress/core 包，简化了依赖管理。

社区反响与生态定位

新版本发布后获得了社区的积极反馈。在 Reddit 的 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 2.0 是一次扎实的进化，尤其在面向未来的 AI 集成和开发体验优化上做出了大胆尝试。对于正在寻找高性能、可定制且具备智能特性的文档解决方案的 React 开发者来说，值得深入研究。如果你有相关使用经验或见解，欢迎在 云栈社区 与其他开发者交流讨论。

原文链接：https://www.infoq.com/news/2026/03/rspress-docs-2-release/