useState
useState 是 React 提供的一个 Hook(钩子),它让函数组件拥有自己的状态,并在状态改变时触发组件重新渲染。
一句话概括:useState 返回一个「当前值 + 修改它的函数」,你调用修改函数,React 就会用新值重新渲染这个组件。
一句话理解
import { useState } from 'react'; function Counter() { // 声明一个名为 count 的状态,初始值为 0 const [count, setCount] = useState(0); return ( <div> <p>你点击了 {count} 次</p> <button onClick={() => setCount(count + 1)}>+1</button> </div> ); }
这段代码做了三件事:
- 声明状态:
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 派生或使用受控组件,参考 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 之后立刻读取新值。
- 状态要放在需要它的最近公共祖先中(状态提升)。
相关页面
- props-state —— Props 与 State 的对比、状态提升
- 事件处理 —— 在事件中更新状态
- 表单处理 —— 用 useState 实现受控表单
- 条件渲染 —— 依据状态切换 UI
- 基础概念 —— 组件与数据流基础
# 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:跨层级共享状态