初始项目 npm run dev 打开文档非常慢，是什么原因？ / Why is npm run dev so slow to open docs in a new project?

[buddacoming]

Linux 下脚手架新建项目，npm run dev 启动，第一次访问时非常慢，几分钟打不开。但是编译似乎都已经完成，不清楚慢的原因。

Local: http://localhost:3000/
➜ Network: http://172.17.0.2:3000/
➜ press h + enter to show shortcuts

start build started...
ready built in 0.28s
start building virtual modules
ready built in 0.08s
start building guide/start/introduction.md and 1 more
ready built in 0.18s
start building en/api/index.mdx
ready built in 0.06s
start building en/api/index.mdx and 1 more
ready built in 0.22s
start building en/api/index.mdx and 2 more
ready built in 0.09s
start building en/api/index.mdx and 3 more
ready built in 0.06s
start building en/api/index.mdx and 4 more
ready built in 0.06s
start building en/api/index.mdx and 5 more
ready built in 0.09s
start building guide/use-mdx/components.mdx and 4 more
ready built in 0.05s
start building guide/start/getting-started.md and 3 more
ready built in 0.06s
start building use-mdx/code-blocks/index.mdx and 2 more
ready built in 0.06s
start building use-mdx/code-blocks/title.md and 1 more
ready built in 0.05s
start building use-mdx/code-blocks/meta.md
ready built in 0.05s

---

In a new project created with the scaffold on Linux, I start it with npm run dev. The first page load is very slow and can take several minutes, even though compilation seems complete. I’m not sure what is causing the delay.

Local: http://localhost:3000/
➜ Network: http://172.17.0.2:3000/
➜ press h + enter to show shortcuts

start build started...
ready built in 0.28s
start building virtual modules
ready built in 0.08s
start building guide/start/introduction.md and 1 more
ready built in 0.18s
start building en/api/index.mdx
ready built in 0.06s
start building en/api/index.mdx and 1 more
ready built in 0.22s
start building en/api/index.mdx and 2 more
ready built in 0.09s
start building en/api/index.mdx and 3 more
ready built in 0.06s
start building en/api/index.mdx and 4 more
ready built in 0.06s
start building en/api/index.mdx and 5 more
ready built in 0.09s
start building guide/use-mdx/components.mdx and 4 more
ready built in 0.05s
start building guide/start/getting-started.md and 3 more
ready built in 0.06s
start building use-mdx/code-blocks/index.mdx and 2 more
ready built in 0.06s
start building use-mdx/code-blocks/title.md and 1 more
ready built in 0.05s
start building use-mdx/code-blocks/meta.md
ready built in 0.05s

[SoonIter]

看着似乎是一个 lazyCompilation 的问题，Rspress 默认启用了 lazyCompilation。

1. 确认是否是 lazyCompilation 的问题，你可以通过将 builderConfig.dev.lazyCompilation 设置为 false 关闭它，看看是否还会遇到页面访问变慢的问题。
2. 协助排查问题时，可以查看页面第一次访问时的网络请求，看看是哪个请求一直处于 pending 状态。
3. 也麻烦提供一个最小复现，方便我们在本地确认问题。

---

This looks like a lazyCompilation issue. Rspress enables lazyCompilation by default.

1. To confirm, set builderConfig.dev.lazyCompilation to false and check whether the page still loads slowly.
2. To help debug it, inspect the first page load in the Network panel and see which request is stuck in pending.
3. Please also provide a minimal reproduction so we can verify the issue locally.

[buddacoming]

本地：Ubuntu 24，npm create rspress@latest，选择多语言自定义theme。在GitHub codespace上也会重现，有随机性，不清楚重现条件。新建项目开始没有这个问题了，添加语言时又出现了。没有错误打印，没有提示信息。页面如果打开过，后面就流畅了，不知道具体什么原因。

[SoonIter]

lazyCompilation 的相关信息如下，

• https://rsbuild.rs/zh/config/dev/lazy-compilation#devlazycompilation
• https://rspress.rs/zh/blog/rspress-v2#build-performance-lazy-compilation-cache

可以确认是否是 lazyCompilation 的问题，你可以通过将 builderConfig.dev.lazyCompilation 设置为 false 关闭它，看看是否还会遇到页面访问变慢的问题。

defineConfig({
   builderConfig: {
        dev: {
           lazyCompilation: false
        }
   }
})

[buddacoming]

npm run build之后的也是慢，新添加了文档之后就慢。可以看一下https://rspress.rs/guide/官网，没打开过的页面，第一次打开时，也会明显卡顿。另外，还有个问题，直接访问https://rspress.rs/guide/basic/i18n类似的路径，每次都会先304跳转一下。

[SoonIter]

可以先按步骤确认一下吗

[SoonIter]

方便的话可以提供一下录屏