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。

适合:

  • 用户输入(表单值、是否勾选)
  • 需要随交互切换的 UI 状态(显示/隐藏、当前标签页、加载中)
  • 从服务器获取的数据及其加载/错误状态
  • 计数器、选中项等会随用户操作变化的局部数据

不适合:

  • 可以由 props 或其他 state 计算得出的数据(直接算,别存)
  • 不参与渲染、变化不需要重绘的数据(用 useRef)
  • 多个不相关组件共享的全局数据(用 Context 或状态管理库)
  • 页面路由、URL 参数(属于路由库的职责)
Hook 作用
useState 组件内部的可变状态(本页)
useReducer 状态逻辑复杂或多个状态相互关联时替代 useState
useRef 存不触发渲染的值,如 DOM 引用、定时器 ID
useEffect 状态变化后与外部系统同步(请求、订阅、DOM 操作)
useContext 跨层级共享状态,避免逐层传 props
  • useState 让函数组件拥有状态,并驱动重新渲染。
  • 返回值是 [当前值, 更新函数] 数组,用解构接收。
  • 初始值只在首次渲染使用,昂贵计算用惰性初始化函数。
  • 更新时优先使用函数式写法,对象/数组保持不可变。
  • 更新是异步且被批处理的,不要在 set 之后立刻读取新值。
  • 状态要放在需要它的最近公共祖先中(状态提升)。
# 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:跨层级共享状态

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • react/usestate.txt
  • 最后更改: 2026/10/14 09:58
  • 由 张叶安