
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',
},
],
},
});