首页
/ Rspress v1.41.3 版本发布:优化预加载与修复多项核心问题

Rspress v1.41.3 版本发布:优化预加载与修复多项核心问题

2025-06-27 06:28:23作者:田桥桑Industrious

Rspress 是一个现代化的静态站点生成器,专为技术文档和博客设计。它基于 React 和 MDX,提供了丰富的主题和插件系统,让开发者能够快速构建高性能的文档网站。在最新发布的 v1.41.3 版本中,Rspress 团队带来了一系列功能优化和问题修复,进一步提升了用户体验和稳定性。

新增功能亮点

页面预加载机制优化

本次更新在 PrevNextPage 组件中新增了预加载功能。当用户在文档中浏览时,系统会智能预加载相邻页面的内容,显著减少了页面切换时的等待时间。这种预加载策略特别适合技术文档这类线性阅读场景,能够为用户提供更加流畅的浏览体验。

核心问题修复

搜索功能路径处理

修复了当配置文件中 outDir 设置为绝对路径时,搜索 JSON 文件路径不正确的问题。现在无论用户如何配置输出目录,搜索功能都能正确定位到所需的索引文件。

路由扩展支持

解决了 route.extensions 配置项未生效的问题。现在开发者可以自由配置路由扩展名,为项目提供了更大的灵活性。

样式与交互优化

针对 UI 进行了多处细节优化:

  • 按钮文本现在会正确居中显示
  • 解决了暗黑模式切换时的布局偏移问题(CLS)
  • 改进了 URL 哈希计算逻辑,确保点击链接时的实时响应
  • 优化了 TOC(目录)高亮逻辑,移除了可能导致闪烁的 setTimeout 实现

MDX 解析增强

改进了 TOC 生成逻辑,现在能够正确处理包含强调(emphasis)和删除线(delete)标记的标题。这意味着即使用户在标题中使用了 强调删除线 等 Markdown 语法,生成的目录结构依然能够保持准确。

构建输出改进

针对模块系统兼容性进行了优化,现在 ESM 输出中会正确使用 import 语句替代 require,确保了在现代 JavaScript 环境中的更好兼容性。

开发者体验提升

本次更新还改进了错误处理机制,现在会输出更详细的错误堆栈信息,帮助开发者更快定位和解决问题。对于文档维护者,更新了关于 lastUpdated 功能的说明,明确了需要提交才能生效的要求。

Rspress v1.41.3 虽然是一个小版本更新,但包含了多项实质性改进,特别是在性能优化和稳定性方面。这些变化使得 Rspress 作为文档工具更加可靠和高效,能够更好地服务于开发者和内容创作者的需求。

登录后查看全文
热门项目推荐