前端 - Vitepress 写产品手册渲染慢（8分钟以上）如何优化？

Question

使用Vitepress写产品手册，渲染比较慢（8分钟以上），有什么解决方法吗？

因为手册功能比较多，有一千多个.md文件，未来可能还会修修补补继续增加一些。

最开始选择vitepress的时候，还有因为很多评论说Vitepress速度快。 现实咋不一样，是我用法问题？

尝试过分成多个子项目，这样文件数就少了，但是这样管理比较麻烦。

Answer 1

我这800多个文件，默认主题，3到5分钟。

没啥好办法，如果文件增长不是很快，就这么用了。

关闭本地搜索功能，会快一点点，但是损失功能增加编译速度，也没必要。

Answer 2

不太清楚你的 Vitepress 项目的主题，可能因为主题的缘故。比如说侧边栏的“最新更新内容”组件，会导致每次编译会影响到大量的页面。如果每次生成全站点的HTML文件那么肯定就会慢。
不过我也没有看到 vitepress 中的缓存相关的配置项（除了 cacheDir ，这是用于开发环境的）

另外也有看到到一个和本地检索生成相关的 PR
�� perf(localSearch): add concurrency pooling, cleanup logic, improve performance by zhangyx1998 · Pull Request #3374 · vuejs/vitepress
但是他那个 large site 最后仍然编译了4分钟。 可能关闭一下内置的 本地检索 功能，会更快一点？

---

不过8分钟也还行吧，一般我们都会通过仓库中的CI/CD来自动部署，并不需要自己手动去维护。如果迁移有成本的话，做好自动部署的 Actions 其实就好了。并不需要管它 build 了多久。

如果说考虑迁移到其他SSG框架的话，可以了解一下 Hugo ？听说非常快，但是也仅仅知道他比 Hexo 快。

Answer 3

Vitepress 渲染慢的问题可能由多种因素导致，包括文档数量、文档大小、Vitepress 配置、以及可能的性能瓶颈等。以下是一些建议的优化措施：

1. 优化 Vitepress 配置

• 确保你使用的是最新版本的 Vitepress，因为新版本可能包含性能优化。
• 检查并优化 Vite 配置（Vitepress 是基于 Vite 的），例如禁用不必要的插件或工具。

2. 减少依赖和插件

• 移除或替换不必要的依赖和插件，因为它们可能会增加构建时间。
• 如果可能，使用轻量级的替代方案。

3. 分割内容

• 尽管你已经尝试过分成多个子项目，但可能需要更精细的分割。考虑按主题或功能将内容分割成更小的部分。
• 使用 Vitepress 的导航和链接功能，确保用户可以轻松地在各个部分之间导航。

4. 使用缓存

• 确保 Vitepress 的构建过程正在使用缓存，以减少不必要的重新构建。
• 如果可能，将缓存持久化到磁盘，以便在多次构建之间重复使用。

5. 优化 Markdown 文件

• 检查 Markdown 文件的大小和内容，确保它们没有不必要的大图像或代码块。
• 考虑使用代码拆分（code splitting）或异步组件（async components）来延迟加载某些内容。

6. 分析和诊断

• 使用 Vite 的分析工具（如 vite build --analyze）来查看构建的性能瓶颈。
• 分析结果可能会帮助你找到需要优化的具体部分。

7. 硬件和环境

• 确保你的开发环境具有足够的资源（如内存和 CPU）。
• 考虑使用更快的构建工具或并行构建来提高性能。

8. 寻求社区帮助

• 如果以上建议都无法解决问题，考虑在 Vitepress 的 GitHub 仓库或相关社区中寻求帮助。
• 提供尽可能详细的信息和错误日志，以便其他人能够更好地帮助你。

9. 重新评估选择

• 如果以上所有方法都无法满足你的需求，并且你仍然需要更快的渲染速度，那么可能需要重新评估是否继续使用 Vitepress。
• 考虑其他静态站点生成器（SSG）或文档工具，看看它们是否更适合你的项目需求。

请注意，每个项目都是独特的，因此可能需要尝试不同的方法才能找到最佳的解决方案。