学 React 别再囤旧教程：官方中文文档带一条完整学习路径

React 老教程满天飞，函数组件和 Hooks 成为主流后，很多旧写法已经不推荐，新手照旧教程学容易走弯路。官方中文文档的 Learn 区从零讲起，示例都能在页面里直接改，每章还留了小练习。

它解决什么问题

搜到的中文 React 教程多半基于旧版类组件写法，和现在项目的代码风格对不上，越学越乱。

社区方案太多，路由、状态管理各推荐一套，不知道哪些是官方认可的方向。

核心能力

先走完 Learn 区，再回来当参考书查

常见误区是把文档当 API 字典翻，结果只记住名词。建议先把 Learn 区按顺序走完，跟着示例敲一遍，把练习做完，一两周就能建立完整的心智模型，之后再用搜索按需查具体接口。

遇到网上教程和官方文档说法冲突时，以官方文档为准。文档里有专门讲「你可能不需要 Effect」这类纠偏章节，正是旧教程最容易教错的地方，值得单独精读。

同类工具怎么选

谁适合用

• 刚接触 React、想按当前最佳实践入门的前端学习者
• 被旧类组件教程困扰、想系统纠正写法的开发者
• 需要向团队推荐统一学习材料的技术负责人

怎么开始

1. 打开 zh-hans.react.dev，首页点「开始 React 之旅」。
2. 按 Learn 区章节顺序读，示例在页面里直接改代码运行。
3. 每章末尾完成小练习再进入下一章。
4. 学到 Hooks 章节时，重点读「你可能不需要 Effect」等纠偏内容。
5. 日常开发时用站内搜索当参考手册查具体接口。

常见问题

中文版更新及时吗？
由社区翻译同步维护，主流章节更新较快，个别新特性可能滞后于英文版。

零基础能直接学吗？
文档假定你已经会 JavaScript 基础，纯新手建议先补语言基础再来。

文档免费吗？
免费。React 开源且文档无付费墙，也不需要注册。

授权与合规

React 以 MIT 协议开源，2026 年起由 Linux 基金会旗下的 React 基金会托管；官方中文文档免费开放，由社区翻译维护。 官网：zh-hans.react.dev。