react中文教程 react入门实例

入门与上手

给零基础前端新手的 React 中文入门路线:从搭环境到跑通第一个组件实例,附排查顺序和该看的站内资料页。

你可能刚学完 HTML 和一点 JavaScript,网上搜 React 教程却全是英文文档、或者一上来就讲 hooks 和状态管理,看得云里雾里。这篇不背概念,只给一条能照着走的路:先装什么、第一段代码写在哪、报错按什么顺序查、卡住时去哪对照。走完一遍,你至少能自己写出一个会响应点击的小组件。

你可能刚学完 HTML 和一点 JavaScript,搜 React 教程却全是英文文档,或者一上来就讲 hooks 和状态管理,看得云里雾里。这篇不背概念,只给一条能照着走的路:先装什么、第一段代码写在哪、报错按什么顺序查、卡住时去哪对照。走完一遍,你至少能自己写出一个会响应点击的小组件。

先说清楚定位:本文是入门动手路线,不是概念百科。判断一个入门教程值不值得跟,看三点——有没有让你立刻敲代码、报错时给不给排查方向、例子是不是小到能一次跑通。三条缺一条,就可以先放一边,换一个再来。

动手之前先备齐这三样

很多人卡住不是卡在 React,是卡在环境或基础。动手前花十分钟做个体检,比后面花两小时找报错划算得多。下面三样缺哪样,先补哪样,不用纠结顺序之外的东西。

  • JavaScript 基础到位:变量、函数、数组方法 map/filter、箭头函数能看懂,看不明白就先补这块再回来
  • 装好 Node.js 和一个顺手的编辑器,终端能执行 node -v 和 npm -v 就算过关
  • 把第一个实例想小:能输入、能点击、能显示结果的计数器就够,别一上手做完整待办清单
现象大概率原因先做哪一步
终端提示命令找不到Node 没装好或没进环境变量装完重开终端,再跑一次版本命令
安装依赖卡住不动网络或镜像源问题换镜像源重试,仍失败再看报错关键词
编辑器里代码没高亮文件后缀不对确认文件名以正确后缀结尾,不是纯文本

第一个实例:从空白文件到能跑的组件

  1. 建项目用官方脚手架建项目,装依赖和起本地服务的命令照抄官方说明即可。起不来时先看终端报的是网络问题还是 Node 版本问题,这两类的解法完全不同。
  2. 先写纯展示先写一个只渲染文字的组件,刷新页面能看见字,说明链路通了。别在这一步加别的,链路没通之前加任何东西都是干扰。
  3. 再加交互确认能显示后,再加输入框和按钮。事件处理写成独立箭头函数,不要在 JSX 里塞大段逻辑,新手最容易在括号和 return 上绕晕。

一个可对照的判断标准:把组件里的逻辑删到只剩返回一段文字,如果页面还报错,问题一定在项目配置或引入导出上,跟你的业务逻辑无关,先解决这个层面再往下写。

让页面动起来:状态与数据流的最小认知

从 jQuery 思路转过来最大的坎就一条:改变显示内容要靠状态变量,不是直接改 DOM。你脑子里想的应该是「改数据、让界面自己重画」,而不是「找到那个元素、把它的文字换掉」。

状态
组件自己记着、变了会触发重画的变量
属性
父组件传给子组件的数据,子组件只读不改
回调
父组件把函数传下去,子组件在合适时机调用来通知父级
key
列表渲染时给每项配的稳定唯一标识,用来帮框架识别哪一项是谁
  • 数据往下传用属性、往上回调用函数,两三层组件用这个办法足够,先别碰全局状态库
  • 列表渲染的 key 要稳定且唯一,用下标当 key 在排序或插入后会出怪问题
  • 状态更新是异步的,别指望改完立刻读出新值,需要连续依赖上一次结果时用函数式写法

报错别慌:一份新手排查顺序

新手最容易犯的错是同时改五处再一起调,结果不知道是哪处坏的。正确姿势是一次只加一处改动,每改一次刷新看结果。真报错了,按下面顺序过一遍,八成能定位。

  1. 看第一条红字浏览器控制台里后面的报错往往是被第一条带出来的,先只盯第一条,把它解决再刷新看还剩什么。
  2. 查导出与引入确认组件有没有正确导出和引入,大小写写错是高频事故,文件名和组件名都要对得上。
  3. 看括号、分号、返回值JSX 语法错基本集中在这几个位置,特别是箭头函数直接返回 JSX 时,圆括号别丢。
  4. 回退到上一个能跑的版本实在找不到就把改动退回去,一次只加一处,逐步逼近问题点,比硬盯着代码猜快得多。
报错位置先怀疑什么验证方式
编辑器就标红语法或括号不配对看标红那一行的上一层括号
页面白屏无报错组件没被渲染或返回了空在父组件里临时写死一段文字确认渲染入口
点击没反应事件没绑上或状态没变在事件函数第一行打日志,看有没有进去
列表顺序乱key 不稳定换成唯一且不随排序变化的值再试

接下来往哪走,不迷路

入门之后最容易迷路:一会儿想学路由,一会儿想学请求数据,一会儿又想上手状态库,结果哪个都没写完。给你一个不迷路的排序原则——先攒够三个能跑通的小实例,再按项目需要补概念。

  • 先做三个小实例再学进阶:计数器、列表过滤、简单表单提交,做完手感就有了
  • 路由、请求数据、状态管理这些按需再学,遇到具体需求再查,不用一开始全啃
  • 看英文文档吃力时,遇到不认识的术语先查基础概念词典,别硬猜意思
  • 想对照各家中转站的可用性和调用成本,去站内价格追踪与评测页看当时的数字,别信截图

还有一个判断标准:如果一个进阶概念你看完教程还是不知道能解决什么具体问题,说明现在还用不上,先跳过,等真的遇到再回来。学不会往往不是难,是没场景。

入门阶段的目标不是学全,是能独立跑通一个小实例并且知道错了去哪查。
下一步想给自己配一个顺手的模型或工具做练习搭档,可以先到站内工具目录和评测页对照当时的可用情况与调用成本,把选择标准看清楚再动手。

常见问题

完全没学过编程,能直接上手 React 吗?

不太建议。React 里到处是函数、数组处理和回调,没有 JavaScript 基础会变成抄代码但不知道在抄什么。建议先把变量、函数、数组的 map 和 filter、箭头函数这几个用熟,能自己写出一个小函数再开始。有 HTML 和 CSS 基础会更顺,但不是硬门槛。

教程里的代码我照着敲了却报错,一般是哪里的问题?

八成是环境或拼写问题,不是逻辑问题。按这个顺序查:终端里依赖装完没有、组件文件名和引入路径大小写对不对、有没有漏掉 export、JSX 里括号和标签闭合是否成对。如果报错说的是找不到模块,先看项目目录结构是不是和教程一致。

学 React 要不要先学 Vue 或者别的框架?

不用,两个选一个开始就行,核心思路(组件、状态驱动视图)是相通的,先学一个把概念吃透比两个都囫囵看一遍强。真正影响你上手速度的是 JavaScript 熟练度,而不是先学了哪个框架。选型纠结的话,去站内技术栈图谱看看社区里都在用什么。

本文依据各平台公开文档与官方公告整理,只做中文归纳;具体做法、参数与限制以官方文档为准。