For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt, and this page is available as Markdown at /zh/guides/upgrade/overview.md.
  • 简体中文

      • 概述

      本文档将帮助您从 Modern.js 2.0 升级到 Modern.js 3.0。

      升级概览

      Modern.js 3.0 带来了多项重大改进和变化，主要包括：

      • 构建工具升级：默认使用 Rspack 构建，不再支持 Webpack，构建配置与 Rsbuild 对齐。
      • React 生态升级：全面支持 React 19 和 React Router v7。
      • 插件系统重构：重新设计插件 API，支持在 CLI、Runtime、Server 层通过自定义插件扩展框架能力。
      • React Server Component：支持在 CSR 和 SSR 项目中使用 React Server Component。
      • 国际化增强：提供开箱即用的 i18n 插件，简化国际化开发流程。
      • SSG 能力完善：提供完整的静态站点生成（SSG）支持。
      • 路由配置增强：支持配置式路由，可单独使用或与约定式路由结合，提供更灵活的路由定义方式。

      升级前置检查

      在开始升级之前，请确认：

      1. 当前项目使用的是 Modern.js 2.0
      2. 确定使用的 react 版本是 17 及以上
      3. 确定使用的 node.js 版本是 18.20.8 及以上，推荐使用 node.js 22 以上版本

      获取帮助

      如果在升级过程中遇到任何问题，您可以通过以下方式获取帮助：

      我们建议在提交 issue 时提供尽可能详细的信息，包括错误日志、配置文件和复现步骤，以便更快地解决问题