docs: add rspack upgrade guide (#3734)

* docs: add the Relationship between Rspack and Modern.js Versions

* fix: capitalization

* Update packages/document/main-doc/docs/zh/guides/advanced-features/rspack-start.mdx

Co-authored-by: neverland <[email protected]>

* Update packages/document/main-doc/docs/zh/guides/advanced-features/rspack-start.mdx

Co-authored-by: neverland <[email protected]>

* Update packages/document/main-doc/docs/zh/guides/advanced-features/rspack-start.mdx

Co-authored-by: neverland <[email protected]>

* Update packages/document/main-doc/docs/zh/guides/advanced-features/rspack-start.mdx

Co-authored-by: neverland <[email protected]>

* Update packages/document/main-doc/docs/zh/guides/advanced-features/rspack-start.mdx

Co-authored-by: neverland <[email protected]>

* Update packages/document/main-doc/docs/zh/guides/advanced-features/rspack-start.mdx

Co-authored-by: neverland <[email protected]>

* Update packages/document/main-doc/docs/en/guides/advanced-features/rspack-start.mdx

Co-authored-by: neverland <[email protected]>

* Update packages/document/main-doc/docs/en/guides/advanced-features/rspack-start.mdx

Co-authored-by: neverland <[email protected]>

* Update packages/document/main-doc/docs/en/guides/advanced-features/rspack-start.mdx

Co-authored-by: neverland <[email protected]>

---------

Co-authored-by: neverland <[email protected]>

Author: 9aoy

packages/document/main-doc/docs/en/guides/advanced-features/rspack-start.mdx

@@ -57,3 +57,41 @@ import appTools, { defineConfig } from '@modern-js/app-tools';
 :::tip
 When migrating from webpack to Rspack, there may have some differences in build and configuration capabilities. For more details, please refer to [Configuration Differences](https://modernjs.dev/builder/en/guide/advanced/rspack-start.html#migrating-from-webpack-to-rspack).
 :::
+
+## The relationship between Rspack and Modern.js versions
+
+Usually, the latest version of Rspack will be integrated into Modern.js. You can update the Modern.js-related dependencies and built-in Rspack to the latest version by using `npx modern upgrade` in your project.
+
+However, Modern.js uses a locked version dependency method (non-automatic upgrade) for Rspack. Due to differences in release cycles, the version of Rspack integrated into Modern.js may be behind the latest version of Rspack.
+
+When Rspack is enabled for building through dev / build, the current version of Rspack used in the framework will be printed automatically:
+
+![rspack_version_log](https://lf3-static.bytednsdoc.com/obj/eden-cn/6221eh7uhbfvhn/modern/img_v2_dfcf051f-21db-4741-a108-d9f7a82c3abg.png)
+
+### Override the Built-in Rspack Version
+
+You can override Rspack to a specific version using the capbilities provided by package managers such as pnpm, yarn, npm.
+
+For example, if you are using pnpm, you can update the Rspack version with `overrides` as shown below:
+
+```json title=package.json
+{
+  "pnpm": {
+    "overrides": {
+      "@rspack/core": "nightly",
+      "@rspack/dev-client": "nightly",
+      "@rspack/dev-middleware": "nightly",
+      "@rspack/plugin-html": "nightly",
+      "@rspack/postcss-loader": "nightly"
+    }
+  }
+}
+```
+
+:::tip What is Rspack Nightly Version
+The Rspack nightly build fully replicates the full release build for catching errors early.
+Usually it is available and any errors that arise will fixed promptly.
+However, if there are any break changes that require modern.js to modify the code, we recommend to wait for the next version of modern.js.
+:::
+
+More examples of using package management tools, please refer to: [Lock nested dependency](/guides/get-started/upgrade.html#lock-nested-dependency).

packages/document/main-doc/docs/zh/guides/advanced-features/rspack-start.mdx

@@ -58,3 +58,40 @@ import appTools, { defineConfig } from '@modern-js/app-tools';
 :::tip
 从 webpack 迁移至 Rspack 时，存在一些构建能力和配置上的差异，详情可参考：[配置差异](https://modernjs.dev/builder/guide/advanced/rspack-start.html#从-webpack-迁移到-rspack)
 :::
+
+## Rspack 和 Modern.js 的版本关系
+
+通常情况下，Modern.js 内会集成 Rspack 的最新版本，通过 `npx modern upgrade` 即可将当前项目中的 Modern.js 相关依赖以及内置的 Rspack 更新至最新版本。
+
+但 Modern.js 对于 Rspack 的依赖方式为锁版本方式(非自动升级)，由于发版周期不同步等原因，可能会出现 Modern.js 内集成的 Rspack 版本落后于 Rspack 最新版本的情况。
+
+当你执行 dev / build 命令时，Modern.js 会自动打印当前使用的 Rspack 版本：
+
+![rspack_version_log](https://lf3-static.bytednsdoc.com/obj/eden-cn/6221eh7uhbfvhn/modern/img_v2_dfcf051f-21db-4741-a108-d9f7a82c3abg.png)
+
+#### 修改内置 Rspack 版本
+
+可以使用 pnpm / yarn / npm 等包管理工具自带的依赖升级功能来将 Rspack 强制升级到指定版本。
+
+以 pnpm 为例，可通过 `overrides` 以下依赖更新 Rspack 版本:
+
+```json title=package.json
+{
+  "pnpm": {
+    "overrides": {
+      "@rspack/core": "nightly",
+      "@rspack/dev-client": "nightly",
+      "@rspack/dev-middleware": "nightly",
+      "@rspack/plugin-html": "nightly",
+      "@rspack/postcss-loader": "nightly"
+    }
+  }
+}
+```
+
+:::tip Nightly 版本介绍
+每天，Rspack 会自动构建基于最新代码的 nightly 版本，用于测试和及早发现错误。
+通常情况下，这些版本是可用的。如果发现问题，我们会及时进行修复。但是，如果 Rspack 有一些 break change，需要 Modern.js 同步修改代码，那么我们建议等待下一个 Modern.js 版本再进行更新。
+:::
+
+如果想了解其他包管理工具锁定依赖版本的示例，可以参考：[锁定子依赖](/guides/get-started/upgrade.html#%E9%94%81%E5%AE%9A%E5%AD%90%E4%BE%9D%E8%B5%96)。