创建一个 React 应用

如果你想用 React 构建一个新的应用或网站,我们推荐从一个框架开始。

如果你的应用程序具有现有框架无法很好满足的约束,你更喜欢构建自己的框架,或者你只想学习 React 应用程序的基础知识,你可以 从头开始构建 React 应用

全栈框架

这些推荐的框架支持你在生产环境中部署和扩展应用所需的所有功能。它们集成了 React 的最新特性,并充分利用了 React 的架构。

注意

全栈框架不需要服务器

本页列出的所有框架都支持客户端渲染(CSR)、单页应用(SPA)和静态站点生成(SSG)。这些应用可以部署到 CDN 或静态托管服务(无需服务器)。此外,这些框架允许你根据实际需求,针对特定路由单独启用服务端渲染。

这意味着你可以从纯客户端应用开始构建,后续需求变更时,无需重写整个应用,即可在特定路由上启用服务端功能。具体渲染策略的配置方法,请参考各框架的官方文档。

Next.js (App Router)

Next.js 的 App Router 是一个 React 框架,充分利用了 React 的架构,支持全栈 React 应用。

Terminal
npx create-next-app@latest

Next.js 由 Vercel 维护。你可以 将 Next.js 应用部署 到任何支持 Node.js 或 serverless 的托管平台,或者部署到你自己的服务器。 Next.js 也支持 静态导出 无需服务器。Vercel 还提供可选的付费云服务。

React Router (v7)

React Router 是 React 最流行的路由库,可以与 Vite 结合创建一个全栈 React 框架。它强调标准的 Web API 并提供了多个 可部署的模板 适用于各种 JavaScript 运行时和平台。

要创建一个新的 React Router 框架项目,请运行:

Terminal
npx create-react-router@latest

React Router 由 Shopify 维护。

Expo (for native apps)

Expo 是一个 React 框架,让你可以创建支持真正原生 UI 的通用 Android、iOS 和 Web 应用。它为 React Native 提供了一个 SDK,让原生部分更易于使用。要创建一个新的 Expo 项目,请运行:

Terminal
npx create-expo-app@latest

如果你是 Expo 新手,请查看 Expo 教程.

Expo 由 Expo 公司 维护。使用 Expo 构建应用是免费的,你可以将应用提交到 Google 和 Apple 应用商店,没有任何限制。Expo 还提供可选的付费云服务。

其他框架

还有一些新兴的框架正在努力实现我们的全栈 React 愿景:

  • TanStack Start (Beta): TanStack Start 是一个由 TanStack Router 驱动的全栈 React 框架。它使用 Nitro 和 Vite 等工具提供完整的文档服务端渲染、流式传输、服务器函数、打包等功能。
  • RedwoodJS: Redwood 是一个全栈 React 框架,带有许多预装的包和配置,方便构建全栈 Web 应用。
深入探讨

哪些特性构成了 React 团队的全栈架构愿景?

Next.js 的 App Router 打包器完全实现了官方的 React Server Components 规范. 这让你可以在同一个 React 树中混合使用构建时、仅服务器端和交互式组件。

例如,你可以编写一个仅在服务器端运行(或在构建期间运行)的服务器端 React 组件,作为 async 函数从数据库或文件中读取数据。然后,你可以将数据传递给将在浏览器中运行的交互式组件:

// 该组件**仅**在服务器端运行(或在构建期间运行)。
async function Talks({ confId }) {
// 1. 你在服务器端,因此可以直接与数据层交互。无需 API 端点。
const talks = await db.Talks.findAll({ confId });

// 2. 添加任意渲染逻辑。这不会使你的 JavaScript bundle 变大。
const videos = talks.map(talk => talk.video);

// 3. 将数据传递给将在浏览器中运行的组件。
return <SearchableVideoList videos={videos} />;
}

Next.js 的 App Router 还集成了 使用 Suspense 的数据获取. 这让你可以直接在 React 树中为用户界面的不同部分指定加载状态(例如骨架占位符):

<Suspense fallback={<TalksLoading />}>
<Talks confId={conf.id} />
</Suspense>

服务器组件和 Suspense 是 React 的特性,而不是 Next.js 的特性。然而,在框架层面采用它们需要开发者的支持和大量的实现工作。目前,Next.js App Router 是最完整的实现。React 团队正在与打包工具开发者合作,以便在下一代框架中更容易实现这些特性。

Start From Scratch

If your app has constraints not well-served by existing frameworks, you prefer to build your own framework, or you just want to learn the basics of a React app, there are other options available for starting a React project from scratch.

Starting from scratch gives you more flexibility, but does require that you make choices on which tools to use for routing, data fetching, and other common usage patterns. It’s a lot like building your own framework, instead of using a framework that already exists. The frameworks we recommend have built-in solutions for these problems.

If you want to build your own solutions, see our guide to build a React app from Scratch for instructions on how to set up a new React project starting with a built tool like Vite, Parcel, or RSbuild.


如果你是一个框架开发者,希望在本页面被推荐,请告知我们