Docusaurus v3.7.0 发布：React 19支持与SVGR插件等新特性

Docusaurus 是一个由 Facebook 开源的静态网站生成器，专门为技术文档网站设计。它基于 React 构建，提供了开箱即用的文档功能、博客支持和可定制的主题系统。最新发布的 v3.7.0 版本带来了一系列重要的新特性和改进。

核心特性更新

React 19 全面支持

Docusaurus v3.7.0 最重要的更新之一是对即将发布的 React 19 的全面支持。这意味着：

1. 所有核心插件和主题组件都已更新类型定义，确保与 React 19 的兼容性
2. 开发者可以提前为 React 19 的新特性做好准备
3. 项目维护了向前兼容性，确保现有项目升级无忧

新增 SVGR 插件

v3.7.0 引入了一个全新的官方插件 docusaurus-plugin-svgr，它提供了：

1. 开箱即用的 SVG 文件导入支持
2. 将 SVG 作为 React 组件使用的能力
3. 与现有构建系统的无缝集成

这个插件解决了在 Docusaurus 项目中处理 SVG 文件的常见痛点，特别是当需要以组件形式使用 SVG 时。

博客系统增强

作者社交媒体图标扩展

博客系统现在支持更多社交媒体平台的作者图标：

1. 新增对多个新兴平台的支持
2. 扩展了包括 Twitch、YouTube 和 Instagram 在内的流行平台
3. 保持了与现有社交图标的一致样式和行为

侧边栏标签定制

博客文章现在支持通过 frontMatter.sidebar_label 属性自定义侧边栏显示标签，这为内容组织提供了更大的灵活性。

性能优化与构建改进

Rspack 增量构建默认启用

构建系统再次默认启用了 Rspack 的增量构建功能，这可以显著提高开发环境下的构建速度，特别是在大型项目中。

问题修复与稳定性提升

1. 修复了 npm-to-yarn 插件中缺少 Bun 包管理器转换的问题
2. 解决了代码块注释在 SQL 语言中的支持问题
3. 修正了文档侧边栏项目可见性的一个关键错误
4. 修复了包含空格的 Markdown 图片路径处理问题
5. 解决了路由名称哈希冲突的可能性

国际化与可访问性

1. 补充了荷兰语(nl)和韩语(ko)的主题翻译
2. 页脚列和链接现在会正确合并提供的 className
3. 改进了 HTML 压缩设置，减少了 React 水合错误

开发者体验改进

1. 开发容器已升级到 Ubuntu Noble 和 Node.js 22
2. Algolia 搜索组件进行了简化重构
3. 移除了 rtl-detect 依赖，改用原生 Intl API 获取语言方向
4. 存储工具函数的工作方式得到了优化

总结

Docusaurus v3.7.0 是一个功能丰富的中期版本更新，它不仅为未来的 React 19 做好了准备，还通过新增的 SVGR 插件和多项功能增强提升了开发体验。性能优化和问题修复使这个版本更加稳定可靠，而国际化支持的完善则让全球开发者受益。对于现有项目，这是一个值得考虑的升级版本，特别是对于那些需要处理 SVG 或计划迁移到 React 19 的项目。