# 开始

这是一个 React 文档及相关资源的概览页面。

React 是一个用于构建用户界面的 JavaScript 库。你可以在 首页教程 中学习什么是 React。

# 体验 React

React 从诞生之初就是可被逐步采用的,因而你可以按需引入或多或少的 React 特性。不管你是想体验下 React,用它给简单的 HTML 页面增加一点交互,还是要开始一个完全由 React 驱动的复杂应用,该章节内容里的链接都能帮你快速开始。

# 在线体验

如果你对体验 React 感兴趣,可以尝试在线代码编辑器。从 CodePenCodeSandboxGlitch, 或者 Stackblitz 开始一个 React 版本的 Hello World 模版。

如果你喜欢使用自己的文本编辑器,也可以 下载这个 HTML 文件 ,然后编辑文件内容,最后再用浏览器从本地文件系统打开文件,预览页面效果。注意:这个文件中包含一个低效率的运行时代码转换脚本,所以我们推荐仅在简单的演示项目中使用。

# 在网站中添加 React

你可以 立即在 HTML 文件中添加 React ,然后选择逐渐拓展它的应用范围,或只在一些动态小部件中使用它。

# 创建新的 React 应用

当你刚开始一个 React 应用时, 通过 HTML 的 script 标签引入 React 依然是最好的选项,因为这能让你的项目立即启动。

但随着应用越来越大,你可能会需要更加集成化的安装方式。我们推荐了一些 JavaScript 工具链,它们适合大型应用。它们只需很少甚至零配置,就能让你充分利用丰富的 React 生态。 立即尝试

# 学习 React

学习 React 的人有着不同的知识背景和学习方式,不管你是理论派还是实践派,我们希望该章节内容对你有帮助。

  • 如果你喜欢,请从实践教程 开始。
  • 如果你喜欢,请从 Hello World 开始。

和所有新技术一样,React 也有一条学习曲线。但只要多多实践和保有一点点耐心,你掌握它。

# 第一个示例

React 首页 包含了一些可在线编辑的小示例。即使你对 React 尚一无所知,也可以尝试修改代码,看看结果会怎样。

# 初学者的 React

如果你觉得 React 官方文档节奏太快,不太适应,可以先去看看这篇 Tania Rascia 的 React 概览 。它以新手友好的方式详细介绍了最重要的 React 概念,看完这篇概览,再回来试试看官方文档吧!

# 设计师的 React

如果你有设计背景, 这些资源 是很好的开始。

# JavaScript 资源

阅读 React 官方文档需要对使用 JavaScript 语言编程有一定基础。你不需要是一个 JavaScript 编程专家,但同时学习 React 和 JavaScript 编程将会比较困难。

我们推荐你浏览 JavaScript 概览 来评估自己的知识水平。这将花费你大约 30 分钟到 1 个小时,但之后学习 React 你会感觉更加自信。

# 实践教程

如果你喜欢边做边学,请参考我们的 实践教程 。在这篇教程中,我们用 React 构建了一个井字棋游戏。你可能想要跳过这部分,尽管你并不是游戏开发者。但请给它一次机会,这篇教程中所涉及的技术是构建 React 应用的基础,掌握它们将让你对 React 有更深的理解。

# 一步步学习指南

如果你喜欢一步步学习概念,我们的 Hello World 是最好的开始。指南里的每一章节都基于前一章节已学的内容,这样一步步过来你不会错过任何知识。

# React 哲学

很多用户认为阅读 React 哲学 是他们最终对 React 恍然大悟的时刻。它可能是最老的 React 教程,但它依然极具价值。

# 推荐课程

相比官方文档,有时人们更喜欢第三方的书籍或视频课程。我们维护了一个 推荐资源清单 ,其中有一些资源是免费的。

# 高级概念

一旦你已经熟知 React 的 主要概念 ,并且已经在项目中小试牛刀,你可能会对更高级的话题感兴趣。该章节内容将会介绍一些强大但并不常用的 React 特性,比如: contextrefs

# API 参考

当你想深入学习特定 React API 细节时,该章节将会变得非常有用。举个例子: React.Component API 参考 能够介绍 setState() 方法是如何工作的,以及不同生命周期方法的使用场景。

# 词汇表与常见问题

词汇表 中包含了 React 文档中最常见术语的概览。常见问题章节致力于简短解答一些大家普遍遇到的问题,包括 发送 AJAX 请求组件状态 以及 文件结构 等。

# 获取最新消息

React 博客 是 React 团队发布更新的官方渠道。一切重要的信息,包括:更新日志,废弃通知等,都会首先在这里发布。

你也可以在 Twitter 上关注 @reactjs 账号 获取更新,但即使不这样做,仅通过官方博客你也不会错过任何必要的信息。

并非每一个 React 版本都值得我们在博客上发布文章,但你可以在 React 代码仓库中的 CHANGELOG.md 文件更新日志页面 找到每个版本的更新日志。

# 版本化文档

官方文档会和最新稳定版的 React 保持同步。从 React 16 开始,你可以在 历史版本页面 找到老版本的 React 文档。注意,老版本的文档是该版本发布时的快照,并不会持续地更新。

# 找不到想要的?

如果你找不到想要的内容或觉得文档某些地方让人疑惑,请 移步文档仓库提交 issue 或在 Twitter 上提及 @reactjs 账号 。我们期待你的反馈!

Last Updated: 5/13/2023, 8:55:38 PM