Rspress

Rspress 是一款基于 Rust 前端工具链的静态站点生成器,专注于快速构建技术文档、博客、组件库演示及轻量官网等静态内容站点。它以性能优化为核心,同时兼顾易用性与扩展性,适配 React/TS 技术栈开发者的使用习惯。

核心特色

  • 极致性能:基于 Rspack 引擎与 Rust 编写的 MDX 编译器,项目启动 / 构建速度比 Docusaurus 快 5~10 倍,大型项目热更新无延迟。
  • 极简上手:无需配置复杂工具链,通过初始化命令即可 30 秒启动站点,导航 / 侧边栏自动生成。
  • 原生兼容:无缝支持 React 组件嵌入 MDX 文档,原生适配 TypeScript,提供完整类型提示。
  • 开箱即用:内置全文搜索、国际化、多版本管理、代码 Demo 预览等核心功能。
  • 灵活部署:输出纯静态 HTML 产物,可直接部署至 GitHub Pages、Vercel 等平台。

快速启动

1. 初始化项目
npm create rspress@latest

2. 进入项目目录
cd your-project-name

3. 启动开发服务
npm run dev

4. 构建生产产物
npm run build

启动后访问 http://localhost:8080 即可查看站点,修改 docs 目录下的 Markdown/MDX 文件实时生效。

简单配置

export default defineConfig({
  root: path.join(__dirname, 'docs'),
  title: '精选面试站',
  icon: '/rspress-icon.png',
  logo: {
    light: '/rspress-light-logo.png',
    dark: '/rspress-dark-logo.png',
  },
  themeConfig: {
    outlineTitle: '目录',
    lastUpdated: true,
    searchPlaceholderText: '搜索文档',
    prevPageText: '上一页',
    nextPageText: '下一页',
    enableContentAnimation: true,
    enableAppearanceAnimation: true,
    enableScrollToTop: true,
    socialLinks: [
      {
        icon: 'github',
        mode: 'link',
        content: 'https://www.xxoo.team',
      },
    ],
  },
});