> For AI agents: the complete documentation index is available at https://www.tteam.icu/zh/llms.txt, the full documentation bundle is available at https://www.tteam.icu/zh/llms-full.txt.

# 笔记从`VuePress`迁移到`Rspress`


AI 总结AI 生成

> `VuePress` 已停止维护，`VitePress` 的构建速度和社区活跃度又不理想，因此笔记站最终选择了 `Rspress`。
迁移并不能只改框架名。真正需要重做的是：
1. 原来的 `code-group` 语法。
2. 对外部代码块的引用。
3. 侧边栏与导航栏的自动生成。
Rspress 带来了更快的基于 Rust 的构建流程，但原有的这些习惯也要一起调整。

[笔记站](https://note.tteam.icu)

我的旧版笔记是使用`VuePress`构建的，由于`VuePress`的维护者已停止维护，且存在一些bug

我也尝试过`VitePress`，但它的编译速度较慢，社区活跃度也不高

编译速度确实非常慢，因此我决定将笔记迁移到`Rspress`平台

`Rspress`基于`Rust`开发，编译速度非常快，且目前社区活跃度很高

## 迁移痛点

### code-group

需要把所有的语法迁移成 `"<Tab>"`

### 引用代码块

之前笔记大量用到`@[code](./foo.js)`的语法，用这种语法引入文件并且渲染成代码块，可以保持`markdown`文件的整洁

然而`rspress`原生并不支持这种语法, 于是我写了个插件[rspress-plugin-code](https://github.com/buyfakett/rspress-plugin-code)来支持

### 自动生成侧边栏和导航栏

让ai把原来的代码进行重构了一下，完美实现了自动生成侧边栏和导航栏