跳到正文
零到全栈 · 卷 4 · 从页面到应用

状态与受控组件

本合集目录
本章目录

单册说明:本文件是卷 4 的第 3 章,可独立阅读。前置:第 2 章(组件与 props)。本章解决"界面怎么跟着数据变":把状态收到一处,让输入框听你的话,并且搞清为什么直接改数组界面不动。

项 内容
所属卷 卷 4 · React 与 Next.js(第 3 / 8 章)
前置章节 4.2 组件、props 与 JSX
本章产出 可新增摘录的表单 + 可筛选的列表,全部由状态驱动
对应代码 src/components/NoteForm.jsx、src/App.jsx
配图 无(后续统一制图)
读完的判定 能说出"为什么 push 之后界面不动",并写出三种正确的不可变更新

4.3.1 一句话结论:你只改状态,界面是状态的函数

上一章结束时,删除功能是能用的:setNotes(notes.filter(...))。现在加"新增",很多人会写成这样:

notes.push(newNote);
setNotes(notes);

点保存:输入框清空了,列表一条没多。打开控制台 console.log(notes.length),确实从 3 变成了 4。

数据变了,界面没变。 这是 React 新手第一个真正的"玄学"时刻,也是本章要拆掉的核心误解:setNotes 不是"通知界面重画",它是"提交一个新值"。React 拿到新值后会和旧值比较,发现是同一个引用,就认为什么都没发生。

4.3.2 原理与方法

useState 与"重新渲染"到底发生了什么

const [notes, setNotes] = useState(seedNotes);

这一行做了三件事:

  1. 第一次渲染时,把 seedNotes 存进 React 内部的一个槽位;
  2. 返回当前值和修改函数;
  3. 之后每次 setNotes(next),把新值存进槽位,并排队一次重新渲染。

"重新渲染"不是刷新页面,是把这个组件函数再执行一遍。理解这一点,很多现象就顺了:

东西 重渲染之后
函数体里的普通变量 重新创建,上次的值丢了
useState 的值 保留(存在 React 内部,不在函数里)
useRef().current 保留,且改它不触发渲染
已提交的 DOM 节点 尽量复用;节点身份变了才重建
输入框里用户没提交的内容 由 DOM 保管,所以"非受控"时不会丢

这也解释了一个常见困惑:"我在函数里 let count = 0,点了三次还是 0。" 因为每次渲染都是新的一次函数调用,count 重新变成 0。要跨渲染记住东西,只有 state 和 ref 两条路。

还有一个优化点:useState 的初始值如果很贵(比如读 localStorage 解析 JSON),传函数进去,它只会在首次执行:

const [notes, setNotes] = useState(() => JSON.parse(localStorage.getItem('notes') ?? '[]'));

写成 useState(JSON.parse(...)),每次渲染都会解析一遍,结果被丢掉,纯浪费。

状态提升:谁需要读,就放到共同祖先

第 2 章里,activeTag 放在 App,TagFilter 只负责显示和上报。这不是随便选的,是唯一正确的放法:

  • TagFilter 需要读它(高亮哪个按钮);
  • NoteList 需要读它(决定显示哪些);
  • 两个组件的共同祖先是 App。
放错的位置 后果
放在 TagFilter 里 按钮高亮了,列表不动——因为列表根本不知道筛选变了
两个组件各存一份 两份状态迟早不一致,且没有任何机制能发现
放在 NoteList 里 筛选器无法控制它,除非再往上提

判断口诀:找到所有需要读这个值的组件,把状态放在它们最近的共同父级。 如果发现要穿过五层 props 才能传下去,才考虑 context(本卷不展开,等数据真的跨多页时再说)。

受控输入:value 和 onChange 必须成对

<input value={title} onChange={(e) => setTitle(e.target.value)} />
  • value 让输入框显示 state 的值;
  • onChange 在每次输入时把新值写回 state。

两者缺一不可。少一个会怎样,这张表说得很清楚:

写法 结果
value + onChange 正常受控。显示的和 state 永远一致
只有 value 输入框变只读,敲键盘没反应,控制台警告(见坑二)
只有 onChange 变成非受控。能打字,但"提交后清空""输入时校验"都做不了
两者都有,但 onChange 里没 setState 打一个字就弹回去,像键盘坏了

为什么表单值得受控?因为值在 state 里,你才能做这四件事:提交前校验、输入时实时过滤、一键清空、多个输入框联动(比如选了"引用"才显示来源链接)。非受控要靠 ref 去 DOM 里捞值,这些都会变得别扭。

代价是每敲一个字都会重渲染一次表单所在的那棵子树。本项目只有几十条数据,完全感觉不到;等到列表上千条、输入明显卡顿时,再考虑把输入框拆成独立组件或用 useDeferredValue。不要在一开始就为此加 useMemo——过早优化换来的复杂度,比那几毫秒贵得多。

不可变更新:不要改,要造一个新的

React 判断"变没变"用的是 Object.is。对数组和对象来说,比的是引用。push、splice、sort、直接赋属性,都改的是同一个引用,React 看不出区别。

操作 错的(原地改) 对的(造新的)
追加 notes.push(n) [...notes, n]
前插 notes.unshift(n) [n, ...notes]
删除 notes.splice(i, 1) notes.filter((x) => x.id !== id)
改一项 notes[i].title = t notes.map((x) => x.id === id ? { ...x, title: t } : x)
排序 notes.sort(...) [...notes].sort(...)
改嵌套 note.tags.push(t) { ...note, tags: [...note.tags, t] }

最后一行是最隐蔽的:你写了 { ...note },以为复制了,但 tags 还是同一个数组的引用,push 之后原对象也变了。浅拷贝只复制第一层,嵌套的每一层都要手动展开。

除了"让 React 看见变化",不可变还有第二个好处:旧的那个数组还在,你可以做撤销、可以对比前后差异、可以在调试器里回看上一帧。原地改等于把历史擦掉了。

批量更新与函数式更新

setCount(count + 1);
setCount(count + 1);
setCount(count + 1);

点一次,结果只加 1。因为三次都读的是本次渲染里的那个 count,三次提交的都是 count + 1 这同一个值。

setCount((v) => v + 1);
setCount((v) => v + 1);
setCount((v) => v + 1);

这样才是加 3。函数式更新拿到的是"队列里最新的值",不是渲染时捕获的旧值。

React 18 之后,同一个事件处理函数里的多次 setState 会被自动批处理成一次渲染。好处是不会中间态闪屏,代价是你 set 完立刻读 state,读到的是旧值:

setNotes(next);
console.log(notes.length); // 还是旧的

真实场景:新增一条后想跳到它的详情页,写成 navigate('/notes/' + notes.at(-1).id),跳过去的是上一条。正确做法是用你刚构造出来的 next,而不是再去读 notes。

派生状态不要存进 state

"筛选后的列表"需要存吗?很多人会:

const [filtered, setFiltered] = useState(notes);

useEffect(() => {
  setFiltered(notes.filter((n) => activeTag === 'all' || n.tags.includes(activeTag)));
}, [notes, activeTag]);

这段代码能跑,但它制造了第四个必须手动同步的地方。新增一条摘录时,只要有一处忘了触发这个 effect,列表就不更新——而且现象和"筛选逻辑写错"一模一样,极难查。

正确写法是一行:

const visible = activeTag === 'all' ? notes : notes.filter((n) => n.tags.includes(activeTag));

每次渲染重算一遍。三条数据的 filter 是微秒级,完全不需要缓存。

该进 state 不该进 state
用户输入的值 能由其他 state 算出来的(筛选结果、计数、是否为空)
从接口拿回来、要跨渲染保留的 每次渲染都会重新得到的常量
用户的选择(当前标签、排序方式) props 的副本(props 变了它不会跟着变)

判断标准一句话:"这个值能不能用现有的 state 推出来?"能,就不要存。

4.3.3 动手:新增表单与标签筛选

NoteForm:一个受控表单

src/components/NoteForm.jsx:

import { useState } from 'react';

const emptyDraft = { title: '', content: '', sourceUrl: '', tags: '' };

export default function NoteForm({ onAdd }) {
  const [draft, setDraft] = useState(emptyDraft);
  const [error, setError] = useState('');

  function update(field) {
    return (e) => setDraft({ ...draft, [field]: e.target.value });
  }

  function handleSubmit(e) {
    e.preventDefault();
    const title = draft.title.trim();
    if (!title) {
      setError('标题不能为空');
      return;
    }
    onAdd({
      title,
      content: draft.content.trim(),
      sourceUrl: draft.sourceUrl.trim(),
      tags: draft.tags.split(',').map((t) => t.trim()).filter(Boolean),
    });
    setDraft(emptyDraft);
    setError('');
  }

  return (
    <form className="form" onSubmit={handleSubmit}>
      <input value={draft.title} onChange={update('title')} placeholder="标题" />
      <textarea value={draft.content} onChange={update('content')} placeholder="正文" rows={3} />
      <input value={draft.sourceUrl} onChange={update('sourceUrl')} placeholder="来源链接" />
      <input value={draft.tags} onChange={update('tags')} placeholder="标签,用逗号分隔" />
      {error && <p className="error">{error}</p>}
      <button type="submit">保存</button>
    </form>
  );
}

三个值得注意的写法:

  1. update(field) 返回一个处理函数,避免写四个几乎一样的 onChange。这是"用函数生成函数",不是立即执行——onChange={update('title')} 会在渲染时调用 update,返回的那个箭头函数才是事件处理器。
  2. 用 e.preventDefault() 拦住表单的默认提交(否则浏览器会刷新整页,state 全丢)。这是 SPA 里最容易忘的一行。
  3. tags 用逗号分隔的字符串,提交时才 split。如果存成数组,每敲一个字符都要处理"逗号还没输完"的中间态,反而更麻烦。

App:接上新增

src/App.jsx 里加:

import NoteForm from './components/NoteForm';

function handleAdd(input) {
  const note = {
    id: `n${Date.now()}`,
    ...input,
    createdAt: new Date().toISOString().slice(0, 10),
  };
  setNotes((prev) => [note, ...prev]);
  setActiveTag('all');
}

setNotes((prev) => [note, ...prev]) 用函数式更新,新的一条放在最前。为什么要 setActiveTag('all')?

因为如果当前筛选是 css,而新摘录没有 css 标签,保存后它会立刻被过滤掉。用户看到的是"我点了保存,什么都没发生",然后重复提交三次。这是产品问题伪装成技术问题,一行代码就能避免。

id 用 Date.now() 是这一卷的临时方案(本地假数据,够用)。卷 5 接了真接口后,id 由后端生成,前端不再自己造。

预期效果:填标题和正文,标签写 js, 读书,点保存。新卡片出现在列表最上方,标签变成两个小方块,表单清空,计数加 1。标题留空点保存,出现红字"标题不能为空",列表不变。

做三个实验,验证你理解了原理

实验一:把不可变改成原地改。

// 把 setNotes((prev) => [note, ...prev]) 换成
notes.push(note);
setNotes(notes);

现象:表单清空了(因为 setDraft 正常),列表一条没多。控制台打印 notes.length 是 4。这就是 4.3.1 开头那个场景。

实验二:去掉 onChange。

把标题输入框改成 <input value={draft.title} placeholder="标题" />。现象:这个框完全打不进字,控制台出现坑二里那条警告。改回来。

实验三:把派生状态存进 state。

按 4.3.2 里的反例,用 useState + useEffect 维护 filtered,但故意在 handleAdd 里只 setNotes 不更新 filtered。现象:新增成功、计数变了、列表没变。你会花十分钟怀疑 filter 写错了,其实只是多存了一份状态。

4.3.4 三个坑

坑一:push / splice 之后界面不更新

症状:点"添加"没反应,点"删除"没反应;console.log 里数组长度确实变了;刷新页面后数据又对(因为重新读了一次源数据)。有时更诡异:列表少了一项,但计数没变。

成因:push、splice、sort、reverse 都返回"原数组"或"被删元素",引用没变。React 用 Object.is 比较新旧 state,同一个引用直接跳过渲染。

修法:所有修改都造新数组——追加用展开、删除用 filter、修改用 map、排序先 [...arr]。判断口诀:看到 push/splice/sort 直接作用在 state 上,就是 bug。

坑二:给了 value 却忘了 onChange

症状:输入框完全打不进字,光标在闪但按键盘没反应,看起来像"页面卡了"。

成因:React 把有 value 无 onChange 的输入框当成只读。控制台会明确告诉你:

Warning: You provided a `value` prop to a form field without an `onChange` handler. This will render a read-only field. If the field should be mutable use `defaultValue`. Otherwise, set either `onChange` or `readOnly`.

修法:补上 onChange。如果确实只想显示不想改,显式写 readOnly,把警告消掉的同时也表达了意图。

坑三:onClick={handleAdd()} 导致无限渲染

症状:页面一打开就卡死,或者点一下按钮后浏览器风扇狂转,控制台:

Too many re-renders. React limits the number of renders to prevent an infinite loop.

成因:JSX 里 {} 是求值,不是"注册回调"。handleAdd() 带括号,会在渲染时立刻执行;它内部调用 setNotes,触发重渲染,重渲染又执行一次 handleAdd()……直到 React 熔断。

修法:传函数本身,或用箭头函数包一层。

<button onClick={handleAdd}>保存</button>          // 事件触发时执行
<button onClick={() => handleAdd(note.id)}>保存</button>  // 需要传参时包一层

顺带记一个同源现象:onSubmit={handleSubmit()} 也会这样,而且它还会让"提交"在页面加载时就跑一次。

本章验收

  • 能用自己的话解释"重新渲染 = 重新执行组件函数",并说出哪些东西会保留
  • 表单四个输入框全部受控,保存后清空,标题为空时报错
  • 亲手把 setNotes([...]) 改成 push 再改回来,看到"数据变了界面不动"
  • 能默写追加、删除、修改一项的三种不可变写法
  • 能说出为什么 filtered 不该放进 useState

自测

Q1:为什么 setNotes(notes) 在 notes.push(x) 之后不会触发更新,而 setNotes([...notes, x]) 会?

看答案 React 用 Object.is 比较新旧 state。push 改的是同一个数组对象,前后引用相同,React 判定"没有变化"并跳过渲染;展开语法创建了一个新数组,引用不同,于是正常排队重渲染。注意 push 的副作用已经发生了——数据确实变了,只是界面不知道,所以这类 bug 特别难查。

Q2:一个页面里 setA(1); setB(2); 连续两次,会渲染几次?这对写代码有什么影响?

看答案 在 React 18+ 的事件处理函数里会被批处理成一次渲染。好处是不会出现"A 已更新、B 还是旧值"的中间态;影响是不能在 set 之后立即读 state 拿新值,需要新值时应该用你构造出来的局部变量,或用函数式更新。

Q3:为什么说"props 的副本不要放进 state"?举一个会出问题的场景。

看答案 useState 的初始值只在首次渲染时使用,之后 props 变化不会同步过去。场景:详情页用 useState(note.title) 做编辑框,用户从 A 切到 B,编辑框里还是 A 的标题,因为组件没卸载、state 没重置。正确做法是直接用 props,或者给组件加 key={note.id} 强制重建。

下一步

状态和表单都就位了,但数据还是从本地数组读的。下一章处理"从外面拿数据"这件事:什么时候发请求、怎么清理、为什么快速切页会让旧结果盖掉新结果。

→ 卷4-04-副作用与数据获取.md