差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 后一修订版 | 前一修订版 | ||
| react:usestate [2026/10/14 09:57] – 创建 张叶安 | react:usestate [2026/10/14 09:58] (当前版本) – 为 useState 页面添加思维导图 张叶安 | ||
|---|---|---|---|
| 行 1: | 行 1: | ||
| - | 1 | + | ====== useState ====== |
| + | |||
| + | '' | ||
| + | |||
| + | 一句话概括:'' | ||
| + | |||
| + | ===== 一句话理解 ===== | ||
| + | |||
| + | <code javascript> | ||
| + | import { useState } from ' | ||
| + | |||
| + | function Counter() { | ||
| + | // 声明一个名为 count 的状态,初始值为 0 | ||
| + | const [count, setCount] = useState(0); | ||
| + | |||
| + | return ( | ||
| + | < | ||
| + | < | ||
| + | <button onClick={() => setCount(count + 1)}> | ||
| + | </ | ||
| + | ); | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | 这段代码做了三件事: | ||
| + | |||
| + | * **声明状态**:'' | ||
| + | * **读取状态**:渲染时用变量 '' | ||
| + | * **更新状态**:调用 '' | ||
| + | |||
| + | ===== 基本用法 ===== | ||
| + | |||
| + | ==== 语法 ==== | ||
| + | |||
| + | <code javascript> | ||
| + | const [state, setState] = useState(initialState); | ||
| + | </ | ||
| + | |||
| + | **必须放在函数组件或自定义 Hook 的最顶层调用**,不能写在条件、循环、嵌套函数里。 | ||
| + | |||
| + | <code javascript> | ||
| + | // 正确:始终在顶层 | ||
| + | function MyComponent() { | ||
| + | const [name, setName] = useState('' | ||
| + | const [age, setAge] = useState(0); | ||
| + | // ... | ||
| + | } | ||
| + | |||
| + | // 错误:写在 if 里,调用顺序会变,React 无法对应状态 | ||
| + | function MyComponent({ show }) { | ||
| + | if (show) { | ||
| + | const [name, setName] = useState('' | ||
| + | } | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | ===== 返回值:为什么是数组 ===== | ||
| + | |||
| + | '' | ||
| + | |||
| + | <code javascript> | ||
| + | const array = useState(0); | ||
| + | const count = array[0]; | ||
| + | const setCount = array[1]; | ||
| + | </ | ||
| + | |||
| + | 所以通常用**数组解构**来接收,取名随意(约定是 '' | ||
| + | |||
| + | <code javascript> | ||
| + | // 名字是自己取的,不是强制的 | ||
| + | const [fruit, setFruit] = useState(' | ||
| + | const [todos, setTodos] = useState([]); | ||
| + | |||
| + | // 用数组而不是对象返回,就是为了让你能自由命名 | ||
| + | </ | ||
| + | |||
| + | ===== 参数:初始值 ===== | ||
| + | |||
| + | 参数只在**首次渲染时使用**,后续渲染会被忽略。 | ||
| + | |||
| + | <code javascript> | ||
| + | // 直接给值 | ||
| + | const [count, setCount] = useState(0); | ||
| + | const [text, setText] = useState('' | ||
| + | const [list, setList] = useState([]); | ||
| + | const [user, setUser] = useState(null); | ||
| + | </ | ||
| + | |||
| + | **惰性初始化**:初始值需要昂贵计算时,传一个**函数**,它只会在首次渲染时执行一次。 | ||
| + | |||
| + | <code javascript> | ||
| + | // 每次渲染都会调用 expensiveComputation(),浪费性能 | ||
| + | const [value, setValue] = useState(expensiveComputation()); | ||
| + | |||
| + | // 只执行一次 | ||
| + | const [value, setValue] = useState(() => expensiveComputation()); | ||
| + | |||
| + | // 从 localStorage 读取也是典型场景 | ||
| + | const [theme, setTheme] = useState(() => localStorage.getItem(' | ||
| + | </ | ||
| + | |||
| + | 如果不给参数,初始值就是 '' | ||
| + | |||
| + | ===== 更新状态 ===== | ||
| + | |||
| + | ==== 直接给新值 ==== | ||
| + | |||
| + | <code javascript> | ||
| + | setCount(5); | ||
| + | setText(' | ||
| + | setList([1, 2, 3]); | ||
| + | </ | ||
| + | |||
| + | ==== 函数式更新(推荐) ==== | ||
| + | |||
| + | 当新值**依赖旧值**时,传一个函数,React 会把最新的状态作为参数传进来: | ||
| + | |||
| + | <code javascript> | ||
| + | // 不推荐:count 是本次渲染时的旧值,连续调用会丢失更新 | ||
| + | setCount(count + 1); | ||
| + | setCount(count + 1); // 结果只加了 1 | ||
| + | |||
| + | // 推荐:基于最新状态计算 | ||
| + | setCount(prev => prev + 1); | ||
| + | setCount(prev => prev + 1); // 结果加了 2 | ||
| + | |||
| + | // 根据 prop 计算 | ||
| + | setCount(prev => prev + step); | ||
| + | </ | ||
| + | |||
| + | **更新对象 / 数组必须创建新引用**,不能直接修改原值: | ||
| + | |||
| + | <code javascript> | ||
| + | const [user, setUser] = useState({ name: ' | ||
| + | |||
| + | // 错误:直接改,引用没变,React 认为状态没变,不重新渲染 | ||
| + | user.age = 26; | ||
| + | setUser(user); | ||
| + | |||
| + | // 正确:复制出新对象 | ||
| + | setUser({ ...user, age: 26 }); | ||
| + | setUser(prev => ({ ...prev, age: prev.age + 1 })); | ||
| + | |||
| + | // 数组同理 | ||
| + | const [items, setItems] = useState([' | ||
| + | setItems([...items, | ||
| + | setItems(items.filter(item => item !== ' | ||
| + | setItems(items.map(i => (i === ' | ||
| + | setItems([...items].sort()); | ||
| + | </ | ||
| + | |||
| + | ===== 状态更新是异步的 ===== | ||
| + | |||
| + | 调用 '' | ||
| + | |||
| + | <code javascript> | ||
| + | function handleClick() { | ||
| + | setCount(count + 1); | ||
| + | console.log(count); | ||
| + | } | ||
| + | |||
| + | // 想在下次渲染拿到新值,就把它写进渲染逻辑或 useEffect 里 | ||
| + | useEffect(() => { | ||
| + | console.log(' | ||
| + | }, [count]); | ||
| + | </ | ||
| + | |||
| + | 若确实需要拿到最新值,用函数式更新;需要基于新状态做后续计算,用 '' | ||
| + | |||
| + | ===== 常见坑 ===== | ||
| + | |||
| + | * **直接修改状态对象/ | ||
| + | * **在条件/ | ||
| + | * **把 props 直接复制进 state**:props 更新后 state 不会跟着变,这类数据应直接从 props 派生或使用受控组件,参考 [[react: | ||
| + | * **忘记用函数式更新**:连续多次更新同一状态时只生效一次。 | ||
| + | * **状态放得太深**:多个组件需要共享时,把状态**提升**到最近公共父组件(状态提升)。 | ||
| + | * **把不参与渲染的数据放进 state**:能用普通变量、useRef 或 props 推导的,就不要放 state。 | ||
| + | |||
| + | ===== 什么时候该用 useState ===== | ||
| + | |||
| + | **适合**: | ||
| + | |||
| + | * 用户输入(表单值、是否勾选) | ||
| + | * 需要随交互切换的 UI 状态(显示/ | ||
| + | * 从服务器获取的数据及其加载/ | ||
| + | * 计数器、选中项等会随用户操作变化的局部数据 | ||
| + | |||
| + | **不适合**: | ||
| + | |||
| + | * 可以由 props 或其他 state 计算得出的数据(直接算,别存) | ||
| + | * 不参与渲染、变化不需要重绘的数据(用 '' | ||
| + | * 多个不相关组件共享的全局数据(用 Context 或状态管理库) | ||
| + | * 页面路由、URL 参数(属于路由库的职责) | ||
| + | |||
| + | ===== 与其他 Hook 的关系 ===== | ||
| + | |||
| + | | Hook | 作用 | | ||
| + | | useState | 组件内部的可变状态(本页) | | ||
| + | | useReducer | 状态逻辑复杂或多个状态相互关联时替代 useState | | ||
| + | | useRef | 存不触发渲染的值,如 DOM 引用、定时器 ID | | ||
| + | | useEffect | 状态变化后与外部系统同步(请求、订阅、DOM 操作) | | ||
| + | | useContext | 跨层级共享状态,避免逐层传 props | | ||
| + | |||
| + | ===== 小结 ===== | ||
| + | |||
| + | * '' | ||
| + | * 返回值是 '' | ||
| + | * 初始值只在首次渲染使用,昂贵计算用惰性初始化函数。 | ||
| + | * 更新时**优先使用函数式写法**,对象/ | ||
| + | * 更新是异步且被批处理的,不要在 set 之后立刻读取新值。 | ||
| + | * 状态要放在**需要它的最近公共祖先**中(状态提升)。 | ||
| + | |||
| + | ===== 相关页面 ===== | ||
| + | |||
| + | * [[react: | ||
| + | * [[react: | ||
| + | * [[react: | ||
| + | * [[react: | ||
| + | * [[react: | ||
| + | |||
| + | ```mdk height=480 color=# | ||
| + | # useState | ||
| + | |||
| + | ## 是什么 | ||
| + | - React 内置 Hook | ||
| + | - 让函数组件拥有自己的状态 | ||
| + | - 状态变化 → 重新渲染 | ||
| + | - 返回「当前值 + 更新函数」 | ||
| + | |||
| + | ## 基本用法 | ||
| + | - `const [state, setState] = useState(初值)` | ||
| + | - 必须写在组件顶层 | ||
| + | - 不能在 if / for / 嵌套函数里调用 | ||
| + | - 变量名可自由取 | ||
| + | |||
| + | ## 初始值 | ||
| + | - 只在首次渲染使用 | ||
| + | - 惰性初始化:`useState(() => fn())` | ||
| + | - 不传参数则为 undefined | ||
| + | |||
| + | ## 更新状态 | ||
| + | - 直接给新值:`setCount(5)` | ||
| + | - 函数式更新:`setCount(prev => prev + 1)` | ||
| + | - 依赖旧值时优先用函数式 | ||
| + | - 对象 / 数组必须创建新引用 | ||
| + | - 不得直接修改原值 | ||
| + | |||
| + | ## 特性与机制 | ||
| + | - 更新是异步的 | ||
| + | - React 自动批处理多次更新 | ||
| + | - set 之后立刻读到的是旧值 | ||
| + | - 想读新值用 useEffect | ||
| + | |||
| + | ## 何时使用 | ||
| + | ### 适合 | ||
| + | - 用户输入、表单值 | ||
| + | - 显隐、选中项、加载状态 | ||
| + | - 服务器返回的数据 | ||
| + | ### 不适合 | ||
| + | - 能由 props / 其他 state 算出 | ||
| + | - 不触发渲染的数据 → useRef | ||
| + | - 跨组件共享 → Context / 状态库 | ||
| + | |||
| + | ## 常见坑 | ||
| + | - 直接改对象或数组 | ||
| + | - 条件中调用 Hook | ||
| + | - 把 props 复制进 state | ||
| + | - 连续 set 却没写函数式 | ||
| + | - 状态放置层级过深 | ||
| + | |||
| + | ## 相关 Hook | ||
| + | - useReducer:复杂状态逻辑 | ||
| + | - useRef:不触发渲染的值 | ||
| + | - useEffect:与外部系统同步 | ||
| + | - useContext:跨层级共享状态 | ||
| + | ``` | ||