====== useState ====== ''useState'' 是 React 提供的一个 **Hook(钩子)**,它让**函数组件拥有自己的状态**,并在状态改变时触发组件重新渲染。 一句话概括:''useState'' 返回一个「**当前值 + 修改它的函数**」,你调用修改函数,React 就会用新值重新渲染这个组件。 ===== 一句话理解 ===== import { useState } from 'react'; function Counter() { // 声明一个名为 count 的状态,初始值为 0 const [count, setCount] = useState(0); return (

你点击了 {count} 次

); }
这段代码做了三件事: * **声明状态**:''useState(0)'' 告诉 React「这个组件有一个状态,初始值是 0」 * **读取状态**:渲染时用变量 ''count'' 拿到当前值 * **更新状态**:调用 ''setCount(...)'' 写入新值,React 自动重新渲染 ===== 基本用法 ===== ==== 语法 ==== const [state, setState] = useState(initialState); **必须放在函数组件或自定义 Hook 的最顶层调用**,不能写在条件、循环、嵌套函数里。 // 正确:始终在顶层 function MyComponent() { const [name, setName] = useState(''); const [age, setAge] = useState(0); // ... } // 错误:写在 if 里,调用顺序会变,React 无法对应状态 function MyComponent({ show }) { if (show) { const [name, setName] = useState(''); } } ===== 返回值:为什么是数组 ===== ''useState'' 返回一个**只有两个元素的数组**: const array = useState(0); const count = array[0]; // 当前值 const setCount = array[1]; // 更新函数 所以通常用**数组解构**来接收,取名随意(约定是 ''xxx'' / ''setXxx''): // 名字是自己取的,不是强制的 const [fruit, setFruit] = useState('apple'); const [todos, setTodos] = useState([]); // 用数组而不是对象返回,就是为了让你能自由命名 ===== 参数:初始值 ===== 参数只在**首次渲染时使用**,后续渲染会被忽略。 // 直接给值 const [count, setCount] = useState(0); const [text, setText] = useState(''); const [list, setList] = useState([]); const [user, setUser] = useState(null); **惰性初始化**:初始值需要昂贵计算时,传一个**函数**,它只会在首次渲染时执行一次。 // 每次渲染都会调用 expensiveComputation(),浪费性能 const [value, setValue] = useState(expensiveComputation()); // 只执行一次 const [value, setValue] = useState(() => expensiveComputation()); // 从 localStorage 读取也是典型场景 const [theme, setTheme] = useState(() => localStorage.getItem('theme') || 'light'); 如果不给参数,初始值就是 ''undefined''。 ===== 更新状态 ===== ==== 直接给新值 ==== setCount(5); setText('Hello'); setList([1, 2, 3]); ==== 函数式更新(推荐) ==== 当新值**依赖旧值**时,传一个函数,React 会把最新的状态作为参数传进来: // 不推荐:count 是本次渲染时的旧值,连续调用会丢失更新 setCount(count + 1); setCount(count + 1); // 结果只加了 1 // 推荐:基于最新状态计算 setCount(prev => prev + 1); setCount(prev => prev + 1); // 结果加了 2 // 根据 prop 计算 setCount(prev => prev + step); **更新对象 / 数组必须创建新引用**,不能直接修改原值: const [user, setUser] = useState({ name: '张三', age: 25 }); // 错误:直接改,引用没变,React 认为状态没变,不重新渲染 user.age = 26; setUser(user); // 正确:复制出新对象 setUser({ ...user, age: 26 }); setUser(prev => ({ ...prev, age: prev.age + 1 })); // 数组同理 const [items, setItems] = useState(['a', 'b']); setItems([...items, 'c']); // 追加 setItems(items.filter(item => item !== 'b')); // 删除 setItems(items.map(i => (i === 'a' ? 'A' : i))); // 修改 setItems([...items].sort()); // 排序也要先复制 ===== 状态更新是异步的 ===== 调用 ''setCount'' 后**不会立刻拿到新值**,渲染也不会马上发生——React 会把多次更新合并成一次重新渲染(批处理)。 function handleClick() { setCount(count + 1); console.log(count); // 还是旧值 } // 想在下次渲染拿到新值,就把它写进渲染逻辑或 useEffect 里 useEffect(() => { console.log('count 更新为', count); }, [count]); 若确实需要拿到最新值,用函数式更新;需要基于新状态做后续计算,用 ''useEffect'',而不是在 set 之后立刻读取。 ===== 常见坑 ===== * **直接修改状态对象/数组**:''user.age = 26'' 不会触发渲染,必须用展开运算符造新对象。 * **在条件/循环里调用 useState**:会破坏 Hook 调用顺序,报错 "Rendered fewer hooks than expected"。 * **把 props 直接复制进 state**:props 更新后 state 不会跟着变,这类数据应直接从 props 派生或使用受控组件,参考 [[react:props-state]]。 * **忘记用函数式更新**:连续多次更新同一状态时只生效一次。 * **状态放得太深**:多个组件需要共享时,把状态**提升**到最近公共父组件(状态提升)。 * **把不参与渲染的数据放进 state**:能用普通变量、useRef 或 props 推导的,就不要放 state。 ===== 什么时候该用 useState ===== **适合**: * 用户输入(表单值、是否勾选) * 需要随交互切换的 UI 状态(显示/隐藏、当前标签页、加载中) * 从服务器获取的数据及其加载/错误状态 * 计数器、选中项等会随用户操作变化的局部数据 **不适合**: * 可以由 props 或其他 state 计算得出的数据(直接算,别存) * 不参与渲染、变化不需要重绘的数据(用 ''useRef'') * 多个不相关组件共享的全局数据(用 Context 或状态管理库) * 页面路由、URL 参数(属于路由库的职责) ===== 与其他 Hook 的关系 ===== | Hook | 作用 | | useState | 组件内部的可变状态(本页) | | useReducer | 状态逻辑复杂或多个状态相互关联时替代 useState | | useRef | 存不触发渲染的值,如 DOM 引用、定时器 ID | | useEffect | 状态变化后与外部系统同步(请求、订阅、DOM 操作) | | useContext | 跨层级共享状态,避免逐层传 props | ===== 小结 ===== * ''useState'' 让函数组件拥有状态,并驱动重新渲染。 * 返回值是 ''[当前值, 更新函数]'' 数组,用解构接收。 * 初始值只在首次渲染使用,昂贵计算用惰性初始化函数。 * 更新时**优先使用函数式写法**,对象/数组**保持不可变**。 * 更新是异步且被批处理的,不要在 set 之后立刻读取新值。 * 状态要放在**需要它的最近公共祖先**中(状态提升)。 ===== 相关页面 ===== * [[react:props-state]] —— Props 与 State 的对比、状态提升 * [[react:事件处理]] —— 在事件中更新状态 * [[react:表单处理]] —— 用 useState 实现受控表单 * [[react:条件渲染]] —— 依据状态切换 UI * [[react:基础概念]] —— 组件与数据流基础 ```mdk height=480 color=#4f46e5 # 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:跨层级共享状态 ```