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:跨层级共享状态
```