性能

概述

Fumadocs MDX 是一个打包器插件，换句话说，它具有更高的性能瓶颈。 使用像 Webpack 和 Turbopack 这样的打包器，对于拥有近 500+ MDX 文件的大型文档站点来说已经足够，这几乎适用于所有用例。

由于 Fumadocs MDX 与您的打包器一起工作，您可以在 MDX 文件中导入任何文件，包括客户端组件。 这提供了高度灵活性，并确保默认情况下一切都得到优化。

图像优化

Fumadocs MDX 使用 Remark Image 将图像解析为静态导入。 因此，您的图像将自动针对您的 React 框架进行优化（例如 Next.js Image API）。

![Hello](./hello.png)

or in public folder

![Hello](/hello.png)

Yields:

import HelloImage from './hello.png';

<img alt="Hello" src={HelloImage} />

注意事项

虽然 Fumadocs MDX 可以处理近 500+ 个文件，但它可能较慢且效率低下。 大量的 MDX 文件可能会导致构建和开发模式下内存使用极高。

这是因为：

• 打包器在幕后做了大量工作来打包 MDX 和 JavaScript 文件并优化性能。
• 打包器不应该编译数百个 MDX 文件。

解决方案

主要解决方案是按需编译，这样内容仅在被请求时加载。

远程源

远程源不需要预编译 MDX 文件，它可以使用 SSG 按需编译它们，这可以极大地提高您的构建速度。 但是，您不能再在 MDX 文件中使用 import。

有关配置远程源，请参阅 Custom Source。

异步模式

请参阅 Async Mode。