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 不会触发渲染,必须用展开运算符造新对象。适合:
不适合:
useRef)| Hook | 作用 |
| useState | 组件内部的可变状态(本页) |
| useReducer | 状态逻辑复杂或多个状态相互关联时替代 useState |
| useRef | 存不触发渲染的值,如 DOM 引用、定时器 ID |
| useEffect | 状态变化后与外部系统同步(请求、订阅、DOM 操作) |
| useContext | 跨层级共享状态,避免逐层传 props |
useState 让函数组件拥有状态,并驱动重新渲染。[当前值, 更新函数] 数组,用解构接收。# 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:跨层级共享状态