目录

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>
  );
}

这段代码做了三件事:

基本用法

语法

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 之后立刻读取。

常见坑

什么时候该用 useState

适合:

不适合:

与其他 Hook 的关系

Hook 作用
useState 组件内部的可变状态(本页)
useReducer 状态逻辑复杂或多个状态相互关联时替代 useState
useRef 存不触发渲染的值,如 DOM 引用、定时器 ID
useEffect 状态变化后与外部系统同步(请求、订阅、DOM 操作)
useContext 跨层级共享状态,避免逐层传 props

小结

相关页面

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