2025 React 状态管理终极指南！

React 作为当下最受欢迎的前端框架，在构建复杂且交互丰富的应用时，状态管理无疑是至关重要的一环。从简单的本地状态，到能让多个组件协同工作的全局状态，再到涉及服务器通信、导航切换、表单操作以及持久化存储等不同场景下的状态管理，每一个方面都影响着应用的性能、用户体验以及可维护性。本文将作为 React 状态管理的全面指南，带你深入了解这些不同类型状态的管理方式与要点。

本地状态

• 定义： 在 React
  中，本地状态是指组件内部管理的数据，这些数据可以影响组件的渲染输出和行为。本地状态是相对于全局状态而言的，它只存在于单个组件中，用于存储那些不需要在整个应用范围内共享的信息。
• 特点：
  私有性：本地状态是特定于某个组件的，其他组件无法直接访问或修改它。
  局部性：状态的变化只会影响该组件及其子组件，而不会影响到父组件或其他兄弟组件。
  生命周期性：随着组件的挂载、更新和卸载，本地状态也会经历相应的生命周期阶段。

函数组件
useState
从 React 16.8 开始引入了 Hooks API，使得函数组件也可以拥有状态。useState 是最常用的 Hook 之一，用来声明和管理组件的状态。

• 返回值：调用 useState 时，返回一个包含两个元素的数组。第一个元素是当前的状态值，可以在组件中直接使用来渲染 UI 等；第二个元素是一个函数，用于更新该状态值，调用这个函数并传入新的值后，React 会重新渲染组件，使 UI 根据新的状态进行更新。

import React, { useState } from 'react';

function Counter() {
  const [count, setCount] = useState(0);

  return (
    <div>
      <p>当前计数: {count}</p>
      <button onClick={() => setCount(count + 1)}>
        Click me
      </button>
    </div>
  );
}

useReducer
对于那些涉及复杂状态逻辑或状态更新依赖于前一状态的情况，useReducer 可能是一个更好的选择。它类似于 Redux 的 reducer 函数，但只作用于单个组件内部。

• reducer 函数：它是整个状态管理的核心逻辑部分，根据传入的不同 action 类型，按照预先定义好的规则来计算并返回新的状态，就像一个状态处理的 “加工厂”，规范了状态更新的流程。
• dispatch 函数：通过调用 dispatch 并传入相应的 action 对象，可以触发 reducer 函数执行，从而实现状态的更新。这使得状态更新的操作更加可预测、可维护，尤其是在复杂的状态变化场景中优势明显。

import React, { useReducer } from 'react';

const initialState = { count: 0 };

function reducer(state, action) {
  switch (action.type) {
    case 'increment':
      return { count: state.count + 1 };
    case 'decrement':
      return { count: state.count - 1 };
    default:
      throw new Error();
  }
}

function Counter() {
  const [state, dispatch] = useReducer(reducer, initialState);

  return (
    <div>
      <p>Count: {state.count}</p>
      <button onClick={() => dispatch({ type: 'increment' })}>+</button>
      <button onClick={() => dispatch({ type: 'decrement' })}>-</button>
    </div>
  );
}

自定义Hooks
可以创建自定义 Hook 来封装特定的状态逻辑，并且可以在多个组件之间共享这些逻辑。这不仅提高了代码的复用性，还使得状态管理更加模块化。

import { useState, useEffect } from 'react';
import axios from 'axios';

const useFetchData = (url, params) => {
  const [data, setData] = useState(null);
  const [isLoading, setIsLoading] = useState(true);
  const [error, setError] = useState(null);

  useEffect(() => {
    const fetchData = async () => {
      try {
        const response = await axios.get(url, { params });
        setData(response.data);
      } catch (err) {
        setError(err.message);
      } finally {
        setIsLoading(false);
      }
    };

    fetchData();
  }, [url, params]); // 依赖项包括 URL 和参数，以便在它们变化时重新获取数据

  return { data, isLoading, error };
};

export default useFetchData;

类组件
在 Hooks 出现之前，React 类组件通过定义 state 对象并在构造函数中初始化它来管理状态。

class Counter extends React.Component {
  constructor(props) {
    super(props);
    this.state = { count: 0 };
  }

  increment = () => {
    this.setState((prevState) => ({ count: prevState.count + 1 }));
  };

  render() {
    return (
      <div>
        <p>当前计数: {this.state.count}</p>
        <button onClick={this.increment}>
          Click me
        </button>
      </div>
    );
  }
}

注意事项：

• 初始化：通常在类组件的构造函数 constructor 中通过给 this.state 赋值来初始化本地状态，设定初始的状态值。
• 更新状态：使用 this.setState 方法来更新状态，它有两种常见的使用形式。一种是直接传入一个包含新状态值的对象，如 this.setState({ count: 10 })；另一种是传入一个函数，函数接收前一个状态 prevState 作为参数，返回新的状态对象，这种方式在基于前一状态进行计算来更新状态时非常有用，能避免一些由于异步操作等带来的状态更新问题。

全局状态

• 定义： 在 React 中，全局状态是指那些在整个应用中多个组件之间需要共享和访问的状态。与本地状态不同，全局状态不局限于单个组件，而是可以在应用的不同部分之间传递、更新和同步。
• 重要性： 当应用变得越来越大，组件之间的嵌套层次越来越深时，使用 props 逐层传递状态（即“props drilling”）会变得非常麻烦且难以维护。全局状态管理工具可以帮助解决这个问题，它们提供了一种集中管理和共享状态的方式，减少了冗余代码，并提高了开发效率。
• 使用选择：

状态提升： 当需要在兄弟组件中共享状态时，可以将状态提升到父组件。
Context API：适合简单的全局状态管理，尤其是当需要避免 props drilling 时。
Zustand：一个轻量级的选择，适合小型到中型应用，特别是那些注重性能和易用性的项目。
Jotai：为更细粒度的状态管理提供了可能性，非常适合那些寻求模块化和高效状态管理的开发者。

状态提升

• 定义： 状态提升是 React 中一种常见的模式，用于将需要在多个组件之间共享的状态移动到它们的最近公共父组件中进行管理。这种方法虽不是全局状态管理的一部分，但它提供了一种方式来集中管理跨多个兄弟组件的状态。
• 原理： 当两个或更多的子组件需要访问相同的数据时，可以将该数据及其相关的更新逻辑“提升”到这些子组件的共同祖先组件中。然后，通过 props 将数据和处理函数传递给需要它的子组件。
• 注意事项：

状态更新的流向：状态更新总是从父组件开始，父组件更新状态后，将新的状态作为 props 传递给子组件，触发子组件的重新渲染。
避免过度提升：不要将所有状态都盲目提升，只提升多个组件需要共享的状态，以保持组件的简洁和清晰。

Context API

• 定义： React 的 Context API 允许创建一个可以在组件树中传递数据的上下文，使得不同层次的组件可以访问这些数据，而无需通过 props 一层层传递。虽然 Context API 本身并不直接提供状态管理功能，但它可以与 Hooks（如 useState）结合使用来实现简单的全局状态管理。
• 基本使用：
  提供者： 在 React 19 之前，可以使用 MyContext.Provider的形式来提供共享状态。React 19 中，可以直接使用 MyContext的形式，省略掉了.Provider。

port React, { useState, createContext } from 'react';
const MyContext = createContext();

function App() {
    const [globalState, setGlobalState] = useState({ count: 0 });

    return (
        <MyContext.Provider value={{ globalState, setGlobalState }}>
            <ComponentA />
            <ComponentB />
        </MyContext.Provider>
    );
}

消费者：在子组件中可以使用 useContext 来获取 MyContext 提供的数据，实现对全局状态的访问和修改。

import React, { useContext } from 'react';
import MyContext from './MyContext';

function ComponentA() {
    const { globalState, setGlobalState } = useContext(MyContext);

    const increment = () => {
        setGlobalState(prevState => ({...prevState, count: prevState.count + 1 }));
    };

    return (
        <div>
            <p>Count: {globalState.count}</p>
            <button onClick={increment}>Increment</button>
        </div>
    );
}

Zustand

• 定义： Zustand 是一个轻量级且易于使用的状态管理库，专门为 React 应用设计。它的名字来源于德语单词 “zustand”，意为“状态”。Zustand 的设计理念是提供一种简单、直观的方式来管理全局状态，同时保持高性能和小体积。
• 特点：
  简洁性：Zustand 的设计理念是保持极简主义，通过简单的 API 和最小化的配置来实现高效的状态管理。
  基于 Hooks：它完全依赖于 React 的 Hooks 机制，允许开发者以声明式的方式订阅状态变化并触发更新。
  无特定立场：Zustand 不强制任何特定的设计模式或结构，给予开发者最大的灵活性。
  单一数据源：尽管 Zustand 支持多个独立的 store，但每个 store 内部仍然遵循单一数据源的原则，即所有状态都集中存储在一个地方。
  模块化状态切片：状态可以被分割成不同的切片（slices），每个切片负责一部分应用逻辑，便于管理和维护。
  异步支持：Zustand 可以轻松处理异步操作，允许在 store 中定义异步函数来执行如 API 请求等任务。
• 基本使用：

1.创建 Store：在 Zustand 中，Store是通过create函数创建的。每个Store都包含状态和处理状态的函数。

import { create } from 'zustand';

const useStore = create((set) => ({
  count: 0, // 初始状态
  increment: () => set((state) => ({ count: state.count + 1 })), // 增加count的函数
  decrement: () => set((state) => ({ count: state.count - 1 })), // 减少count的函数`在这里插入代码片`
}));

其中， create函数接受一个回调函数，该回调函数接受一个set函数作为参数，用于更新状态。在这个回调函数中，定义了一个count状态和两个更新函数increment和decrement。

2. 使用 Store：在组件中，可以使用自定义的 Hooks（上面的useStore）来获取状态和更新函数，并在组件中使用它们。

import React from 'react';
import { useStore } from './store';

function Counter() {
  const { count, increment, decrement } = useStore();
  
  return (
    <div>
      <p>Count: {count}</p>
      <button onClick={increment}>Increment</button>
      <button onClick={decrement}>Decrement</button>
    </div>
  );
}

3. 订阅特定状态片段：如果有一个包含多个状态的store，但在组件中只需要订阅其中一个状态，可以通过解构赋值从useStore返回的完整状态对象中提取需要的状态。Zustand的智能选择器功能允许这样做，而不会导致不必要的重新渲染。

// store.js
import { create } from 'zustand';
 
const useStore = create((set) => ({
  count: 0,
  name: 'Zustand Store',
  increment: () => set((state) => ({ count: state.count + 1 })),
  setName: (newName) => set({ name: newName }),
}));
 
export default useStore;

在组件中，如果只想订阅count状态，可以这样做：

// MyComponent.js
import React from 'react';
import useStore from './store';

function MyComponent() {
  const { count } = useStore((state) => ({ count: state.count }));

  return (
    <div>
      <p>Count: {count}</p>
    </div>
  );
}

export default MyComponent;

Jotai

• 定义： Jotai 是一个轻量级且灵活的 React 状态管理库，采用原子化状态管理模型。它受到了 Recoil 的启发，旨在提供一种简单而直观的方式来管理 React 中的状态。
• 核心思想：
  原子化状态管理：Jotai 使用原子作为状态的基本单位。每个原子代表一个独立的状态片段，可以被多个组件共享和访问。
  组合性：通过组合 atoms 和选择器，可以构建复杂的、依赖于其他状态的状态逻辑。这种组合性使得状态管理更加模块化和灵活。
  细粒度依赖跟踪：Jotai 内置了高效的依赖跟踪机制，只有当组件实际依赖的状态发生变化时才会触发重新渲染。
• 基本使用：
  简单原子创建：定义一个 atom 来表示应用中的某个状态片段。
  1.创建 Atom：

import { atom } from 'jotai';

export const countAtom = atom(0);

派生原子创建（基于已有原子进行计算等）

import { atom } from 'jotai';
import { countAtom } from './atoms';

export const doubleCountAtom = atom((get) => get(countAtom) * 2);

2.使用 Atom：

• 使用 useAtom Hook 获取和更新原子状态（适用于读写原子状态场景）：

import React from 'react';
import { useAtom } from 'jotai';
import { countAtom } from './atoms';

const Counter = () => {
  const [count, setCount] = useAtom(countAtom);

  return (
    <div>
      <p>Count: {count}</p>
      <button onClick={() => setCount((prev) => prev + 1)}>Increment</button>
      <button onClick={() => setCount((prev) => prev - 1)}>Decrement</button>
    </div>
  );
};

export default Counter;

• 使用 useAtomValue Hook 仅获取原子状态（适用于只读场景）：

import React from 'react';
import { useAtomValue } from 'jotai';
import { doubleCountAtom } from './derivedAtoms';

const DoubleCounter = () => {
  const doubleCount = useAtomValue(doubleCountAtom);

  return <p>Double Count: {doubleCount}</p>;
};

export default DoubleCounter;

• 使用 useSetAtom Hook 仅获取更新原子状态的函数（适用于只写场景）：

import React from 'react';
import { useAtomValue } from 'jotai';
import { countAtom } from './derivedAtoms';

const IncrementButtonComponent = () => {
    const setCount = useSetAtom(countAtom);
    return (
        <button onClick={() => setCount((prevCount) => prevCount + 1)}>Increment</button>
    );
};

服务器状态

• 定义： 服务器状态指的是应用与服务端交互相关的状态，包括从服务器获取的数据（如 API 响应）以及请求的状态（如加载中、完成、失败等）。

• 重要性：
  数据一致性：确保前端展示的数据是最新的，并且与服务器上的数据一致。
  用户体验：提供即时反馈，比如加载指示器、错误消息等，以改善用户的交互体验。
  缓存策略：合理地使用缓存可以减少不必要的网络请求，提高性能并节省带宽。
  错误处理：优雅地处理网络故障或其他异常情况，保证应用的稳定性和可靠性。

• 使用选择：
  useState + useEffect：当只需要从服务器加载一次数据，并且不需要复杂的缓存或重试机制时使用。
  自定义 Hooks： 当多个组件中有相似的数据获取模式，可以将这部分逻辑提取成一个自定义 Hook 来减少重复代码。
  React Query：一个强大的工具，特别适用于需要全面数据获取功能的大型应用。
  SWR：以其简洁性和对实时性的支持而闻名，是那些追求快速集成和良好用户体验的应用的理想选择。

useState + useEffect
在 React 中，管理服务器状态的最常见模式是结合使用useState和useEffect Hook。

• useState：用于定义组件内的状态变量。这些状态可以保存从服务器获取的数据、加载标志（例如isLoading），以及可能发生的错误信息。
• useEffect：用来处理副作用，比如发起网络请求。它可以在组件挂载或状态变化时执行特定的操作。在网络请求开始前，将isLoading设为true，表明正在加载数据。当接收到服务器响应后，依据响应内容更新相关状态变量，并将isLoading设为false。如果请求过程中发生错误，还可以设置一个错误状态变量来存储错误信息。

mport React, { useState, useEffect } from 'react';

function APP() {
  // data保存服务器返回的数据，loading表示是否正在加载，error保存可能发生的错误信息。
  const [data, setData] = useState(null);
  const [loading, setLoading] = useState(true);
  const [error, setError] = useState(null);

  const fetchData = async () => {
    try {
      const response = await fetch('https://api.example.com/data');
      if (!response.ok) {
        throw new Error('Network response was not ok');
      }
      const result = await response.json();
      setData(result); // 更新数据状态
    } catch (err) {
      setError(err.message); // 设置错误信息
    } finally {
      setLoading(false); // 请求完成后关闭加载状态
    }
  }

  useEffect(() => {
    fetchData();
  }, []);

  if (loading) return <p>Loading...</p>;
  if (error) return <p>Error: {error}</p>;

  return (
      <ul>
        {data.map(item => (
          <li key={item.id}>{item.name}</li>
        ))}
      </ul>
    </div>
  );
}

export default DataFetcher;

这种方式存在问题：

• 代码冗余： 在多个组件中重复编写用于获取不同服务器数据的 useState 和 useEffect 代码，不仅增加了开发成本，还使得代码结构变得复杂，难以维护和扩展。这种冗余可以通过创建自定义 Hook 或采用更高级的状态管理解决方案来有效缓解。
• 状态一致性： 当多个组件依赖于相同的服务器数据时，很难保证它们之间的状态一致性。例如，如果一个组件更新了数据，另一个组件可能不会立即感知到，需要手动实现状态同步的逻辑，可能会导致不同组件显示的数据不一致。
• 缺乏高级特性： 基础的状态管理方式缺乏一些高级特性，如自动缓存、自动数据重新获取以及乐观更新等。对于复杂的数据更新场景，如部分更新或失效数据的重新获取，开发者需要手动编写大量的额外代码来实现这些功能。
• 性能问题： 由于缺乏内置的缓存机制，对于频繁请求的数据，每次组件重新渲染时都可能触发新的请求，从而增加性能开销。此外，依赖相同数据的多个组件无法共享数据缓存，导致网络资源的浪费和不必要的请求开销。
• 复杂的错误处理：在处理不同类型的错误（如网络错误、服务器端错误、权限错误等）时，开发者需要进行手动区分和处理，这增加了错误处理的复杂性。同时，实现自动重试机制或提供用户友好的错误提示也需要额外的复杂逻辑和代码编写。

自定义 Hooks
为了优化 useState 和 useEffect 组合使用时所遇到的问题，可以使用自定义 Hook 来封装常见的服务器请求操作。这里将以 ahooks 提供的的 useRequest 为例。

aHooks 是一个由蚂蚁金服开发的 React Hooks 库，它提供了一系列实用的自定义Hooks来简化常见的开发任务。

useRequest 的特性如下：

• 自动请求/手动请求
• SWR(stale-while-revalidate)
• 缓存/预加载
• 屏幕聚焦重新请求
• 轮询
• 防抖
• 节流
• 并行请求
• 依赖请求
• loading delay
• 分页
• 加载更多，数据恢复 + 滚动位置恢复

import { useRequest } from 'ahooks';
import React from 'react';
import Mock from 'mockjs';

function getUsername(): Promise<string> {
  return new Promise((resolve) => {
    setTimeout(() => {
      resolve(Mock.mock('@name'));
    }, 1000);
  });
}

export default () => {
  const { data, loading, run, cancel } = useRequest(getUsername, {
    pollingInterval: 1000,
    pollingWhenHidden: false,
  });

  return (
    <>
      <p>Username: {loading ? 'loading' : data}</p>
      <button type="button" onClick={run}>
        start
      </button>
      <button type="button" onClick={cancel} style={{ marginLeft: 8 }}>
        stop
      </button>
    </>
  );
};

当然，我们也可以根据需求来完全自定义 Hooks。
React Query
React Query（现称为 TanStack Query）是一个专为React应用设计的数据获取、缓存和状态管理库。它通过简化常见的数据操作任务，如发起HTTP请求、处理加载状态、错误处理等，极大地提升了开发效率和用户体验。
React Query 的功能如下：

• 简化数据获取：可以使用 useQuery Hook 可以轻松发起网络请求，自动处理加载状态、错误处理，并返回响应数据。支持多种类型的请求，包括RESTful API 和 GraphQL。
• 内置缓存机制：自动管理和优化缓存，减少不必要的网络请求。提供 cacheTime 和 staleTime 配置项来控制缓存的有效期和数据的新鲜度。
• 自动重新获取数据：支持在特定情况下自动刷新数据，如窗口重新聚焦 (refetchOnWindowFocus) 或者网络连接恢复 (refetchOnReconnect)。有助于确保用户始终看到最新的数据，特别是在长时间离开页面后再返回时。
• 并发模式支持：确保在网络请求未完成时安全地卸载组件，避免内存泄漏和其他潜在问题。
• 乐观更新与突变管理：通过 useMutation Hook 支持创建、更新或删除资源的操作。实现乐观更新，即先显示预期的结果，如果请求失败则回滚到原始状态。
• 无限滚动与分页：使用 useInfiniteQuery Hook 来实现无限滚动功能，简化分页逻辑的管理。
• 开发工具：提供 ReactQueryDevtools 开发工具，帮助开发者清晰地观察每个请求的状态及其相关缓存信息。
• 手动触发请求：允许通过 manual 选项将请求设置为手动触发，配合 run 方法按需发起请求。
• 全局配置：可以通过 QueryClient 进行全局配置，如设置默认的缓存时间、重试策略等。

import {
  useQuery,
  useMutation,
  useQueryClient,
  QueryClient,
  QueryClientProvider,
} from '@tanstack/react-query'
import { getTodos, postTodo } from '../my-api'

const queryClient = new QueryClient()

function App() {
  return (
    <QueryClientProvider client={queryClient}>
      <Todos />
    </QueryClientProvider>
  )
}

function Todos() {
  const queryClient = useQueryClient()

  const query = useQuery({ queryKey: ['todos'], queryFn: getTodos })

  const mutation = useMutation({
    mutationFn: postTodo,
    onSuccess: () => {
      queryClient.invalidateQueries({ queryKey: ['todos'] })
    },
  })

  return (
    <div>
      <ul>{query.data?.map((todo) => <li key={todo.id}>{todo.title}</li>)}</ul>

      <button
        onClick={() => {
          mutation.mutate({
            id: Date.now(),
            title: 'Do Laundry',
          })
        }}
      >
        Add Todo
      </button>
    </div>
  )
}

render(<App />, document.getElementById('root'))

SWR
SWR 是 “stale-while-revalidate” 的缩写，它是一个用于数据获取和缓存的React Hooks库，由 Vercel 开发。SWR 专为构建快速响应的用户界面而设计，它的工作原理是先返回缓存的数据，然后在后台发起请求获取最新的数据，并在收到新数据后更新UI。这种模式可以提供即时的用户体验，同时确保数据保持最新。

SWR 的特性如下：

• 即时响应：当组件首次渲染时，SWR 会立即返回缓存中的旧数据（如果有）。这使得用户界面能够瞬间加载，无需等待网络请求完成。
• 自动重验证：一旦从缓存中读取了数据，SWR 就会在后台发起请求以获取最新数据。这个过程对用户来说是透明的，只有当新数据到达时才会更新UI。
• 简单的API：SWR 提供了一个非常直观的 useSWR Hook 来简化数据获取逻辑，包括处理加载状态、错误和成功情况。
• 支持多种数据源：虽然 SWR 最常用于HTTP请求，但它也可以与其他类型的数据源一起工作，比如 WebSocket 或者本地存储。
• 优化性能：SWR 内置了一些性能优化特性，如并发模式支持、自动垃圾回收和去抖动/节流功能，帮助减少不必要的请求。
• 开发工具集成：与 React Query 类似，SWR 也提供了开发者工具来监控和调试数据获取行为。
• 灵活配置：可以通过配置选项自定义刷新策略、重试机制等，以适应不同的应用场景需求。
• 服务端渲染（SSR）兼容：SWR 支持服务器端渲染，可以在页面初次加载时预先填充缓存，从而加快客户端的首次渲染速度。

import React, { useState } from 'react';
import useSWR from 'swr';
import axios from 'axios';

// 自定义的 fetcher 函数，使用 axios
const fetcher = (url) => axios.get(url).then((res) => res.data);

// 自定义的 SWR 配置选项
const swrConfig = {
    // 重试次数
    retry: 3,
    // 缓存时间（毫秒）
    revalidateOnFocus: false,
    shouldRetryOnError: false,
};

function BlogPosts() {
    const [page, setPage] = useState(1);
    const perPage = 10;

    // 构建 API URL，包含分页参数
    const apiUrl = `https://api.example.com/posts?page=${page}&perPage=${perPage}`;

    // 使用 SWR 获取文章数据
    const { data: posts, error, isValidating } = useSWR(apiUrl, fetcher, swrConfig);

    // 数据转换：按日期排序
    const sortedPosts = posts?.sort((a, b) => new Date(b.date) - new Date(a.date)) || [];

    if (error) return <div>加载出错: {error.message}</div>;
    if (!posts) return <div>正在加载... {isValidating && '重新验证...'}</div>;

    return (
        <div>
            <h1>博客文章</h1>
            <ul>
                {sortedPosts.map((post) => (
                    <li key={post.id}>
                        <h2>{post.title}</h2>
                        <p>{post.content}</p>
                        <small>发布于: {new Date(post.date).toLocaleDateString()}</small>
                    </li>
                ))}
            </ul>
            <button onClick={() => setPage(page - 1)} disabled={page === 1}>
                上一页
            </button>
            <button onClick={() => setPage(page + 1)}>
                下一页
            </button>
        </div>
    );
}

export default BlogPosts;

导航状态

• 定义： React 导航状态是指与应用内部页面或视图之间的导航相关的状态。它包括但不限于当前路由信息、历史记录栈、参数传递以及可能的其他元数据。当进行路由导航时，有时需要将前一个页面的状态带到新页面，以确保用户体验的一致性和连续性。通常，在 React 项目中会借助 React Router、TanStack Router 等路由库来实现状态管理。

React Router

• 定义： React Router 是 React 应用中最常用的路由库，提供了丰富的路由功能，支持路由匹配、嵌套路由、路由参数提取、动态路由、重定向等。可以方便地与 React 应用集成，实现页面之间的导航和导航状态的管理。

• 使用：在 React Router 中，可以通过路径参数、查询参数、状态对象来实现状态管理。

Link：创建一个导航链接，to=“/product/123” 表示点击该链接会跳转到 /product/123 路径。
Route：定义路由规则，path=“/product/:productId” 是一个包含路径参数的路由，productId 是参数名称。

useParams：在 ProductDetail 组件中，通过 useParams 钩子函数可以获取到当前匹配路由的路径参数。在这个例子中，它将从 URL 中提取 productId 并显示在页面上。
路径参数： 路径参数通常用于在 URL 路径中传递信息。

// 定义路由
import { BrowserRouter as Router, Route, Routes } from 'react-router-dom';
import UserDetail from './UserDetail';

function App() {
  return (
    <Router>
      <Routes>
        <Route path="/users/:userId" element={<UserDetail />} />
      </Routes>
    </Router>
  );
}

export default App;

// 路由跳转
<Link to="/users/123">用户中心</Link>

// 使用参数
import { useParams } from 'react-router-dom';

function UserDetail() {
  const { userId } = useParams();

  return (
    <div>
      <h1>User Detail</h1>
      <p>User ID: {userId}</p>
    </div>
  );
}

export default UserDetail;

查询字符串：查询字符串通常用于在 URL 查询字符串中传递信息。
useLocation：通过 useLocation 获取当前页面的位置信息，包括查询参数。
new URLSearchParams(location.search)：将 location.search 部分（以 ? 开始的查询字符串）解析为一个 URLSearchParams 对象。
queryParams.get(‘keyword’) 和 queryParams.get(‘category’)：通过 get 方法从 URLSearchParams 对象中获取相应的查询参数。

// 定义路由
import { BrowserRouter as Router, Route, Routes } from 'react-router-dom';
import SearchResults from './SearchResults';

function App() {
  return (
    <Router>
      <Routes>
        <Route path="/search" element={<SearchResults />} />
      </Routes>
    </Router>
  );
}

export default App;

// 路由跳转
<Link to="/search?keyword=phone">搜索</Link>

// 使用参数
import { useLocation } from 'react-router-dom';

function SearchResults() {
  const location = useLocation();
   const queryParams = new URLSearchParams(location.search);

  return (
    <div>
      <h1>搜索结果</h1>
      <p>关键词: {queryParams.get('keyword') || 'None'}</p>
    </div>
  );
}

export default SearchResults;

状态传递：状态对象通常用于在导航时传递复杂的状态信息。
useNavigate 支持传递额外的状态对象给目标页面。这些状态不会出现在 URL 中，但在目标页面可以通过 useLocation Hook 获取。

// 源页面传递状态
import { useNavigate } from 'react-router-dom';

function ProductList() {
  const navigate = useNavigate();

  const handleAddToCart = (productId) => {
    navigate('/cart', {
      state: { productId }
    });
  };

  return (
    <div>
      <h1>商品列表</h1>
      <button onClick={() => handleAddToCart('123')}>添加到购物车</button>
    </div>
  );
}

export default ProductList;

// 新页面使用状态
import { useLocation } from 'react-router-dom';

function Cart() {
  const location = useLocation();
  const { state } = location;

  return (
    <div>
      <h1>购物车</h1>
      {state ? (
        <p>商品ID: {state.productId}</p>
      ) : (
        <p>购物车为空</p>
      )}
    </div>
  );
}

export default Cart;

TanStack Router

• 定义： Tanstack Router 是由 TanStack 团队开发的一个用于 React 和其他框架的高性能路由库。Tanstack Router 强调性能、可扩展性和易用性，支持多种渲染环境，包括客户端、服务端和静态站点生成。
• 特点：
  动态路由匹配：支持复杂的路径模式，例如参数化路径、通配符等。
  嵌套路由：可以定义父子关系的路由结构，适用于构建复杂的应用布局。
  编程式导航：提供了类似 useNavigate 的 Hook 来执行编程式导航。
  状态管理：内置对 URL 状态的支持，方便地将查询参数和路径参数传递给组件。
  跨框架兼容：不仅限于 React，还支持 Vue、Solid 等其他前端框架。
  性能优化：通过懒加载（Lazy Loading）、代码分割（Code Splitting）等技术来提高应用性能。
  插件系统：拥有丰富的插件生态，可以轻松添加额外的功能，如身份验证、缓存控制等。
  服务端渲染（SSR）和静态站点生成（SSG）支持：确保应用在不同渲染环境中都能良好运行。
  服务端渲染（SSR）和静态站点生成（SSG）支持：确保应用在不同渲染环境中都能良好运行。
• 使用：
  路径参数： 路径参数是 URL 中固定位置的部分，用来标识特定资源或视图。例如，/products/:id。在 TanStack Router 中，可以使用 useParams Hook 来获取路径参数。

// 定义路由
import { createRouter } from '@tanstack/react-router';

const router = createRouter({
  routes: [
    {
      path: '/products/:id',
      element: () => import('./pages/ProductDetail'),
    },
  ],
});

export default router;

// 获取路径参数
import React from 'react';
import { useParams } from '@tanstack/react-router';

function ProductDetail() {
  const params = useParams();

  return <div>{params.id}</div>;
}

export default ProductDetail;

查询字符串：查询字符串是以问号 (?) 开始并由与号 (&) 分隔的一系列键值对，通常用于携带非层次结构的数据，如搜索关键词、排序选项、过滤条件等。在 TanStack Router 中，可以使用 useSearchParams Hook 来访问和修改查询字符串。

// 路由跳转
import { Link } from '@tanstack/react-router';

function SearchLink() {
  return (
    <Link to="/search?q=laptop&sort=price_asc">搜索</Link>
  );
}

// 获取查询参数
import React from 'react';
import { useSearchParams } from '@tanstack/react-router';

function SearchResults() {
  const [searchParams] = useSearchParams();
  const query = searchParams.get('q') || '';
  const sort = searchParams.get('sort') || 'desc';

  return (
    <div>
      <p>搜索: {query}, 分类: {sort}</p>
    </div>
  );
}

export default SearchResults;

URL 中，但它们可以通过编程式导航来传递，并在目标页面中通过 useLocation Hook 获取。

// 传递状态
import { useRouter } from '@tanstack/react-router';

function SubmitFormButton() {
  const router = useRouter();

  function handleSubmit() {
    const formData = {
      name: 'John Doe',
      email: 'john.doe@example.com',
    };

    // Navigate to the next page and pass state
    router.navigate('/confirmation', { state: formData });
  }

  return <button onClick={handleSubmit}>Submit Form</button>;
}

// 获取状态
import React from 'react';
import { useLocation } from '@tanstack/react-router';

function ConfirmationPage() {
  const location = useLocation();
  const { state } = location;
  const { name, email } = state || {};

  return (
    <div>
      <p>Name: {name}</p>
      <p>Email: {email}</p>
    </div>
  );
}

export default ConfirmationPage;

总结：

React 状态管理在过去几年中经历了巨大的演变，从最初的 setState 到 Context API，再到 Redux、Recoil、Zustand 等状态管理库的兴起，开发者们拥有了越来越多的工具来应对复杂应用的状态管理需求。2025 年，React 状态管理的核心思想依然是 “状态的可预测性、可维护性和性能优化”，但随着技术的进步，我们也看到了更多创新的解决方案和最佳实践。

在这份终极指南中，我们深入探讨了 React 状态管理的各个方面，包括组件内部状态、外部控制状态、全局状态管理、性能优化以及测试策略。以下是关键总结：

1. 状态管理的多样性：

   • 对于简单场景，useState 和 useReducer 依然是最直接的选择。
   • 对于跨组件状态共享，Context API 提供了轻量级的解决方案。
   • 对于大型应用，Redux、Recoil 或 Zustand 等库提供了更强大的工具来管理复杂状态。

2. 外部控制组件的崛起：

   • 通过将状态提升到父组件或全局状态管理中，开发者可以更好地控制组件的逻辑和数据流。
   • 受控组件的模式（通过 props 和回调函数管理状态）已成为构建可复用和可测试组件的标准实践。

3. 性能优化的关键性：

   • 使用 React.memo、useMemo 和 useCallback 来避免不必要的渲染。
   • 通过状态管理的模块化和懒加载，减少初始加载时间和运行时开销。

4. 测试与可维护性：

   • 单元测试和集成测试是确保状态管理逻辑正确性的重要手段。
   • 使用 Jest 和 React Testing Library 可以高效地模拟用户交互和验证状态更新。

5. 未来趋势：

   • 随着 React Server Components 和并发模式的普及，状态管理将更加注重服务端与客户端的协同。
   • 轻量级状态管理库（如 Recoil 和 Zustand）将继续受到青睐，尤其是在中小型项目中。
   • 状态管理的自动化和智能化（如基于 AI 的状态优化工具）可能会成为新的发展方向。

无论你是 React 新手还是经验丰富的开发者，掌握状态管理的核心原则和最新工具都是提升开发效率和应用性能的关键。希望这份指南能为你提供清晰的思路和实践方向，帮助你在 2025 年及未来的 React 开发中游刃有余！继续探索、实践和创新，React 的状态管理世界将为你打开更多可能性！