去年做后台的订单列表,每行右侧有个“取消订单”。测试同学点了一下,确认弹窗正常关掉,列表上的状态却还是“待发货”。刷新页面之后才变成“已取消”。后端接口其实已经成功了,问题全在前端。
代码大致是这样,现在看很明显,当时我们三个人盯了半小时:
const [orders, setOrders] = useState(initialOrders);
function cancelOrder(id) {
const target = orders.find((item) => item.id === id);
target.status = "cancelled"; // 直接改对象
setOrders(orders); // 传回去的还是同一个数组
}
对象确实被改了,但数组的引用没变。React 判断“要不要重新渲染”时,比较的是新旧 state 的引用,用的是 Object.is。同一个数组引用,它认为什么都没发生,于是就什么都不做。列表没变,控制台也没报错,这就是最难查的那类 bug。
这篇就从这个问题往外讲:React 18 的函数组件里,props 和 state 到底该怎么改,为什么这么改,以及一个订单列表从“能跑”到“能上线”中间还差哪几步。
先划清范围:这篇讲的是 React 18
本文按 React 18 及以后的客户端渲染讲,示例环境是 Vite 创建的项目,不涉及 React 19 的 Server Components、use()、Actions 这些新 API。如果你现在装的是 19,这篇里关于 JSX、props、state、key 的内容依然适用,因为它们是 React 的核心模型;但服务端组件是另一套运行方式,不能混在一起讲。
建项目用官方脚手架,模板选 React 加 JavaScript:
npm create vite@latest order-demo -- --template react
cd order-demo
npm install
npm run dev
入口文件会是这样,注意 React 18 用的是 createRoot,不是旧的 ReactDOM.render:
// main.jsx
import { createRoot } from "react-dom/client";
import App from "./App.jsx";
createRoot(document.getElementById("root")).render(<App />);
组件文件后缀用 .jsx,因为里面会有 JSX 语法。用 .js 也能跑,但编辑器提示和格式化经常不认,没必要省这两个字符。后面所有示例都可以直接放进这个项目里跑,控制台结果只在纯 JavaScript 能验证的地方写。
JSX 是函数调用,不是模板语言
很多人第一眼把 JSX 当成 HTML 模板,于是拿它跟 Vue 的模板对比,问“怎么循环、怎么条件判断”。其实 JSX 在编译后就是一个普通的函数调用,元素是对象,组件是函数。你写 <OrderTotal items={items} />,编译产物大意是调用 OrderTotal 这个函数,参数是一个对象 { items: items }。
这件事带来三个直接的结论。组件名必须大写,因为小写标签会被当成字符串交给浏览器,React 不会去调用同名函数。props 就是函数的第一个参数,所以组件签名写成 function OrderTotal({ items }),解构出来就是 props 里的字段。组件函数每渲染一次就执行一次,函数体里的局部变量全部重新创建,这一点在讲 Hooks 时会变得非常关键。
写 JSX 时有几个天天会遇到的细节。返回多个并列元素要包一层,或者用空标签 <>...</> 作为 Fragment。插入 JavaScript 表达式用一对花括号,但花括号里不能写语句,if 和 for 要提前算好。条件渲染里 {count && <p>...</p>} 在 count 为 0 时会把 0 渲染出来,因为 0 是假值但不是 null,这种“页面上莫名多个零”的问题我见过好几次,改成三元或 Boolean(count) 就好。
看一个完整的小组件,理解“输入 props、返回元素”这个形状:
function OrderTotal({ items }) {
const totalCents = items.reduce((sum, item) => sum + item.priceCents, 0);
return <p>合计:{(totalCents / 100).toFixed(2)} 元</p>;
}
// 使用
<OrderTotal items={order.items} />
这里 items 是输入,返回的 <p> 元素是输出。函数里没有网络、没有定时器、没有 DOM 操作,同样的输入永远得到同样的输出。这种组件最好测,也最好复用,上一篇讲展示组件时说的就是这个形状。
props 只读,state 不可变更新
props 是父组件传下来的,React 在开发环境会冻结它,你直接改会报错或者静默失效。这不是限制你,而是在保证数据流向单一:一个值只有一个来源,改的时候去改来源,不要在接收方动手。
state 没有强制冻结,但你必须按不可变的方式更新。原因是 React 靠引用比较来判断变化,浅比较省事也快。另一个原因是可追溯:每次更新产生新对象,旧状态还在,调试、回滚、并发渲染才有依据。这块和对象的引用语义是同一件事,不熟的话建议先回头看那篇。
具体写法就那么几个。删一项用 filter,改一项用 map,加一项用展开加新元素,排序用 slice 先复制再 sort。数组的 push、splice、sort、reverse 都是原地修改,直接用就会踩开头那个坑。这些方法的区别在数组方法那篇有完整对照。
// 删掉一行:返回新数组
setOrders((prev) => prev.filter((item) => item.id !== id));
// 改一行:只替换命中的那项,其余保持原引用
setOrders((prev) =>
prev.map((item) =>
item.id === id ? { ...item, status: "cancelled" } : item
)
);
// 改嵌套字段:每一层都要复制
setForm((prev) => ({
...prev,
address: { ...prev.address, city: "上海" }
}));
最后一段要特别注意:展开只复制一层。如果 address 里面还有 geo,你只复制到 address,geo 仍然是共享的旧对象。改 geo 的时候必须再展开一层,否则界面不会更新。嵌套超过三层,代码会变得很难读,这时候要么把数据结构拍平,要么引入不可变数据库(比如 immer),但那是一个额外的依赖,别在第一天就上。
setState 是批处理的,旧值要用函数式更新
先记住一句话:setState 不会立刻改变当前这次渲染里的变量,它只是告诉 React“下次渲染请用新值”。所以在 setCount(count + 1) 后面立刻 console.log(count),打印的还是旧值,这是正常的,不是 bug。
React 18 会把同一个事件循环里的多次更新合并成一次渲染,这叫自动批处理。它不只作用于事件处理函数,setTimeout、Promise 回调里的更新也会合并。合并的直接后果是:连续写两次 setCount(count + 1),两次读到的 count 都是本次渲染的那个值,最后只加了一。
function Counter() {
const [count, setCount] = useState(0);
function handleClick() {
setCount(count + 1);
setCount(count + 1); // 两次都基于同一个旧 count,最终只加 1
}
return <button onClick={handleClick}>{count}</button>;
}
改成函数式更新就对了。setCount((prev) => prev + 1) 把“怎么算新值”交给 React,React 会按顺序把每次更新作用到最新的值上,两次就是加二。
function Counter() {
const [count, setCount] = useState(0);
function addTwice() {
setCount((prev) => prev + 1);
setCount((prev) => prev + 1); // 最终加 2
}
return <button onClick={addTwice}>{count}</button>;
}
什么时候必须用函数式?新值依赖旧值的时候,以及在异步回调、定时器、订阅回调里更新的时候。因为那些回调里的 count 来自它被创建的那次渲染,可能已经过期很久了。这个问题本质上就是闭包,Hooks 那篇会把它讲透。
还有一个推论:不要写“设置完马上读”的代码。比如先 setPage(page + 1) 再 fetchList(page),请求用的还是旧页码。要么把新页码算出来先存变量,要么把请求放进 useEffect,依赖页码变化。
列表 key、条件渲染与受控输入
这三件事看起来不相关,但都属于“React 怎么知道该更新谁”。key 决定列表项的身份,条件渲染决定元素出不出现,受控输入决定表单值归谁管。搞混任何一个,都会出现“数据是对的、界面是错的”这种问题。
key 不是给 React 看的,是给 diff 用的
列表里每个元素要给一个 key,React 靠它在两次渲染之间匹配“这还是不是同一项”。没有 key 或者用数组下标当 key,在“只在末尾追加”时没问题,一旦中间插入、删除、排序,身份就会错位。
最典型的表现是输入框串值。列表每行有个输入框,你删掉第二行,第三行的输入框里却显示着第二行没打完的字。因为 React 按下标匹配,认为“第 2 个输入框还在,只是 value 变了”,于是复用了原来的 DOM 和光标位置。用数据库的 id 当 key 就不会。
key 只需要在兄弟之间唯一,不需要全局唯一。也不要用随机数,因为每次渲染都变,等于告诉 React“所有项都是新的”,整棵列表会重建,性能更差。如果数据确实没有 id,在数据进入前端时生成一个稳定 id,别在渲染函数里用 Math.random()。
受控与非受控:谁是数据的唯一来源
受控输入指的是表单元素的 value 绑在 state 上,用户输入触发 onChange 改 state,state 再驱动 value。数据只有一条路,所以你能实时校验、联动禁用、格式化。代价是每次按键都要走一次渲染,超大表单会有手感问题。
function KeywordInput() {
const [keyword, setKeyword] = useState("");
return (
<input
value={keyword}
onChange={(event) => setKeyword(event.target.value)}
placeholder="搜索订单号"
/>
);
}
如果写了 value 却忘了 onChange,输入框会变成只读,怎么打字都不动,控制台还会提示你。如果 value 绑的是 A 状态、onChange 改的是 B 状态,表现是“打字有反应,但显示不变”,这类问题查起来很快,看一眼两个变量是不是同一个就行。
非受控输入用 defaultValue,需要取值时用 ref 读 DOM。它适合三种场景:文件上传(file 类型的值本来就不能由代码设置)、超大型表单只提交时取一次值、以及和第三方非 React 组件集成。日常的业务表单,优先受控,因为后续加校验、加联动会省很多事。
最后是条件渲染。用 if 提前返回适合整块区域,三元适合两个分支,&& 适合“有就显示、没有就拉倒”。但记住上面说的 0 的坑,数字字段前面不要直接用 &&。列表为空时也别只渲染一个空 <ul>,给用户一句“暂无订单”,这是产品细节,不是技术问题。
完整场景走查:订单列表从能跑到能上线
需求不复杂:订单列表支持按状态筛选、分页、取消订单。取消前弹确认框,取消成功后列表状态立刻变,失败要提示并回滚。切换筛选时回到第一页,请求过程中显示加载态,出错显示原因。
第一版我们只做了“能跑”。列表数据从接口拿一次放进 state,取消时找到那一项直接改 status,筛选用一个 filtered state,在 useEffect 里随订单变化重新算,key 用了数组下标。测试环境数据少,看着一切正常。
上线后暴露了五个问题。取消订单后列表状态不变,就是开头那个引用问题。删除中间一行后,后面几行的备注输入框串了值,因为 key 是下标。筛选条件切了两次,filtered 和 orders 短暂不一致,出现“筛选是待发货、列表里却有已取消”。分页在第一页点“上一页”,页码变成 0,请求报错。取消失败时没有任何提示,用户以为成功了。
第二版把状态重新理了一遍。筛选条件和页码进 state,列表数据进 state,加载态和错误各一个 state;筛选后的列表不再用 state 存,直接在渲染时算,因为它是派生值,存两份必然会不同步;取消用不可变更新做乐观更新,失败时回滚并给出错误:
function OrderPage() {
const [status, setStatus] = useState("all");
const [page, setPage] = useState(1);
const [orders, setOrders] = useState([]);
const [loading, setLoading] = useState(false);
const [error, setError] = useState("");
useEffect(() => {
let ignore = false; // 防止旧请求覆盖新结果
setLoading(true);
setError("");
fetch("/api/orders?status=" + status + "&page=" + page)
.then((res) => {
if (!res.ok) throw new Error("HTTP " + res.status);
return res.json();
})
.then((data) => {
if (!ignore) setOrders(data.list);
})
.catch((err) => {
if (!ignore) setError(err.message);
})
.finally(() => {
if (!ignore) setLoading(false);
});
return () => {
ignore = true; // 依赖变化时,旧请求的结果作废
};
}, [status, page]);
async function cancelOrder(id) {
const before = orders;
setOrders((prev) =>
prev.map((item) =>
item.id === id ? { ...item, status: "cancelled" } : item
)
);
try {
const res = await fetch("/api/orders/" + id + "/cancel", {
method: "POST"
});
if (!res.ok) throw new Error("取消失败,请重试");
} catch (err) {
setOrders(before); // 回滚到操作前
setError(err.message);
}
}
function changeStatus(next) {
setStatus(next);
setPage(1); // 换筛选回到第一页
}
if (loading) return <p>加载中</p>;
if (error) return <p>{error}</p>;
return (
<div>
<select value={status} onChange={(e) => changeStatus(e.target.value)}>
<option value="all">全部</option>
<option value="paid">待发货</option>
<option value="cancelled">已取消</option>
</select>
<ul>
{orders.map((order) => (
<li key={order.id}>
{order.no} · {order.status}
<button onClick={() => cancelOrder(order.id)}>取消订单</button>
</li>
))}
</ul>
<button onClick={() => setPage((p) => Math.max(1, p - 1))}>上一页</button>
<button onClick={() => setPage((p) => p + 1)}>下一页</button>
</div>
);
}
几个改动对应着前面讲的东西。key 换成 order.id,输入框不再串值。取消用 map 生成新数组,引用变了,界面才更新。页码用函数式更新加 Math.max,第一页再点也不会变 0。筛选后的列表不再单独存 state,避免两份数据不一致。useEffect 里返回的清理函数把 ignore 置为真,旧请求回来后不写状态,这是最小成本的竞态处理,正规做法是用 AbortController,下一篇细讲。
还没解决的是 props 下钻。列表拆成了 OrderList、OrderRow、OrderActions,cancelOrder 要从页面传到行再到按钮,三层。现在还能接受,等列表上面再加一层筛选面板、下面再加一层批量操作,就会变成六层。这个问题不是靠“再拆细一点”能解决的,下一篇讲 Hooks 时会给出复用逻辑的思路。
错误现象对照
下面这些现象我在真实项目里都见过,共同点是控制台不报错,只能靠表现倒推。按“看到什么、真实原因、先查哪里”整理:
| 现象 | 真实原因 | 第一步查什么 |
|---|---|---|
| 改了数据,列表完全不动,刷新后才对 | 原地修改数组或对象,引用没变,React 判定无需渲染 | 在 setState 前打印新旧值,看两者是不是同一个引用 |
| 删掉中间一行,后面几行的输入框串了值 | key 用了数组下标,React 按位置复用了 DOM | 看 key={index} 还是 key={item.id} |
| 连点两次“加一”,只加了一次 | 两次都基于同一次渲染的旧值,且被批处理合并 | 看是不是 setCount(count + 1),改成函数式 |
| 输入框打不了字,或打字后显示不变 | 写了 value 却没写 onChange,或两者绑了不同 state |
核对 value 和 onChange 用的是不是同一个变量 |
页面上莫名出现一个 0 |
条件渲染写成 {count && ...},count 为 0 时被直接渲染 |
把 && 改成三元,或加 Boolean() |
| 切换筛选很快时,列表闪回上一个条件的结果 | 旧请求后到并覆盖了新结果,没有取消或忽略机制 | 看 useEffect 有没有清理函数、有没有请求序号 |
| 开发环境里同样的请求发了两遍 | StrictMode 在开发环境故意把 effect 跑两次 | 用生产构建再验一次;确认清理函数是否让第一次失效 |
最后一条要单独说明:这不是 React 的 bug,也不是配置错了。StrictMode 用“挂载、卸载、再挂载”的方式,逼你写出能正确清理的 effect。开发时看到两条请求很正常,生产构建只有一条。不要为了消掉这两条请求去删 StrictMode,那是把体检报告撕了。
边界与代价
React 这套模型有明确的成本,不是所有页面都值得上。第一,不可变更新要复制数据,列表上万条时一次 map 就是一次全量遍历,频繁操作会有可感知的卡顿。第二,深嵌套数据写展开很啰嗦,容易漏层,这也是各种不可变数据库存在的原因。第三,useEffect 里做数据请求会形成瀑布,也没有缓存,生产项目通常要配请求库或框架的数据层,这已经超出“起步”的范围。
规模上的经验:一个组件超过两百行、或者同时管五个以上状态,就该拆了;页面级的组件树超过二十个,需要目录约定和统一的数据获取方式;跨页面共享的状态超过三处,就该考虑状态管理,而不是继续往上提 state。
什么时候不该用 React:纯内容展示的站点,服务端模板加一点脚本更简单也更快;交互只有展开收起、切换 tab 的活动页,几十行原生脚本就够;团队完全没有函数式编程经验、项目周期只有两周,学习成本会把收益吃掉。框架不是立场,是工具。
版本边界也要说清楚。React 19 的服务端组件需要框架(比如 Next.js)配合构建,不是装个包就能用;use() 的细节和缓存语义在不同版本有过调整,具体行为以你项目锁定的版本为准,拿不准的地方标“待确认”比编一个结论好。React Compiler 的稳定版本与生态支持情况也在变化,同样待确认,本文的写法不依赖它。
小结
下面几条今晚就能在本地跑一遍,不需要业务代码:
- 在 Vite 的 React 18 项目里写一个计数器,故意连续调用两次
setCount(count + 1),确认只加一;改成函数式,确认加二。 - 写一个待办列表,删除用
filter、改标题用map,key用id;然后把 key 换成下标,在中间插入一项,观察输入框是否错位。 - 写一个受控输入,先把
onChange删掉,看控制台警告;再把value绑到另一个 state,观察“能打字但不显示”。 - 在列表请求的
useEffect里加一行console.log,用开发环境跑,数一数 StrictMode 下执行几次;再npm run build后用npm run preview数一次。 - 翻项目里所有
setXxx,找形如setList([...list, item])的写法,逐个改成函数式更新,确认行为不变。
把状态更新规则弄清楚之后,下一个坎马上就来:组件不能只跟自己玩,它要发请求、要监听窗口大小、要操作 DOM。这些“React 之外的东西”怎么接进来、什么时候接、接错了会怎样,就是 Hooks 要解决的问题。下一篇讲React Hooks:状态、副作用与依赖数组,从一个“搜了三次,三次都在搜第一个词”的搜索框讲起。