一、项目介绍

写文档站、做开源站点，最怕构建慢、配置重、内容用 Markdown 写却要迁就笨重框架。VitePress 已经够快，但有些团队想要更贴近 Rspack/Rsbuild 工具链的体验——更激进的构建性能，以及和 Rstack 生态统一。
Rspress 是字节 Web Infra 团队出品的静态站点生成器，构建在 Rsbuild/Rspack 之上，主打「快」。它支持 Markdown/MDX，开箱即用搜索、i18n、主题，是 Rstack（面向开发者与 Agent 的 JS 工具链）的一员。对已经或打算用 Rspack 体系的团队，它把文档站也纳入了同一套高速工具链。

二、项目基本信息

信息项详情
项目名称rspress
GitHub地址https://github.com/web-infra-dev/rspress
项目描述🦀 A fast Rsbuild-based static site generator.
作者web-infra-dev
开源协议MIT License
开源状态公开
LanguagesTypeScript
支持平台Web
最后更新2026-10-28

三、核心优势

  • 极速构建：基于 Rspack，冷启动与构建都很快
  • MDX 支持：Markdown 中直接写组件，灵活度更高
  • 文档站开箱：搜索、i18n、主题一站式
  • 生态统一：作为 Rstack 一员，与 Rspack/Rsbuild 协同
  • 轻量产物：静态输出，部署到任意托管

四、适用场景

适合需要高速文档站、并与 Rspack/Rsbuild 工具链保持一致的团队。开源项目文档、产品官网均可用。

五、安装教程

当前最新版本 v2.0.23。按下方命令安装：

npm create rspress@latest
# 或手动引入核心包
npm install @rspress/core

常见报错：依赖缺失时先升级对应运行环境（Node、Python、.NET、Rust、Go、Bun、JDK）；网络超时多为镜像或代理问题，可重试或换源；Docker 相关确保已安装并启动 Docker 服务。

六、使用示例

下面是一段可直接参考的真实示例：

# 创建项目后启动开发服务器
npm run dev
# 构建发布
npm run build
# 预览产物
npm run preview

七、常见问题

问：和 VitePress 比？答：二者都快，Rspress 基于 Rspack 并支持 MDX，更贴近 Rstack 生态。问：支持多语言？答：i18n 开箱即用，配置即可启用。

八、总结

rspress 用清晰的设计，把把文档与站点生成自动化这件事从重复劳动变成了可复用、可维护的工程能力。它不追求大而全，而是把核心痛点解决得足够扎实，这正是日常开发与团队落地时最需要的那种工具。如果你也在被同类问题困扰，不妨按上面的安装与使用步骤试一试，把它接进自己的工作流。