React / 系统课时
Context 跨层共享
Context 跨层共享
本课解决属性需要逐层传递的问题。你将创建一个 Context,把主题信息从顶层提供给深层组件,并掌握 Provider、消费组件与默认值之间的职责边界。
学习目标
- 创建 Context 并在组件树上层提供数据
- 使用
useContext在任意后代组件中读取共享值 - 识别 Context 的适用场景与性能边界
为什么需要 Context
当顶层组件的数据只被深层组件使用时,若仍通过 props 一层层转交,中间组件会被迫接收自己并不关心的参数。这种现象通常称为属性逐层传递。
Context 在组件树中建立一个共享范围:Provider 提供值,范围内的后代组件按需读取。中间组件无需声明或转发对应 props。

创建并提供 Context
下面的完整示例创建主题 Context,并在顶层组件中提供当前主题及切换函数。深层的 ThemeButton 不需要经过 Layout 转发数据。
import { createContext, useContext, useState } from "react";
const ThemeContext = createContext(null);
function ThemeButton() {
const context = useContext(ThemeContext);
// 自定义错误能比读取 null 属性更快暴露 Provider 缺失问题
if (context === null) {
throw new Error("ThemeButton 必须位于 ThemeContext.Provider 内");
}
const { theme, toggleTheme } = context;
return (
<button type="button" onClick={toggleTheme}>
当前主题:{theme}
</button>
);
}
function Layout() {
return (
<main>
<h2>设置面板</h2>
<ThemeButton />
</main>
);
}
export default function App() {
const [theme, setTheme] = useState("light");
function toggleTheme() {
setTheme((current) => (current === "light" ? "dark" : "light"));
}
return (
<ThemeContext.Provider value={{ theme, toggleTheme }}>
<Layout />
</ThemeContext.Provider>
);
}预期结果
页面初始显示“当前主题:light”。
点击按钮后显示“当前主题:dark”,再次点击切换回 light。
Layout 不需要接收或转发 theme 与 toggleTheme。createContext(null) 创建上下文对象,Provider 的 value 决定当前共享值。useContext(ThemeContext) 会读取距离当前组件最近的同类 Provider;当 Provider 的值改变时,使用该 Context 的组件会重新渲染。
默认值与 Provider 范围
createContext 的参数只在组件上方找不到 Provider 时生效。默认值不是 Provider 初始值,也不会随着状态变化。对于必须依赖 Provider 的业务 Context,使用 null 作为默认值并在自定义 Hook 中检查,通常更容易发现配置错误。
可以把读取逻辑封装起来。下面是片段示例,依赖 React 运行环境,并要求调用方在组件树上层提供 UserContext.Provider:
import { createContext, useContext } from "react";
export const UserContext = createContext(null);
export function useCurrentUser() {
const user = useContext(UserContext);
if (user === null) {
throw new Error("useCurrentUser 必须在 UserContext.Provider 内使用");
}
return user;
}生效行为
Provider 范围内调用 useCurrentUser() 时返回当前用户对象。
Provider 缺失时立即抛出明确错误,而不是继续使用无效数据。这段代码是可复用模块,使用时还需要在组件树上层渲染 UserContext.Provider 并传入真实用户对象。
适用场景与性能边界
Context 适合主题、登录用户、语言、权限摘要和全局配置等“许多后代组件需要、但更新频率不高”的数据。局部表单值或只在相邻组件间传递的数据,优先使用 props,数据来源会更清晰。
Provider 的 value 改变后,所有消费该 Context 的后代都可能重新渲染。若把大量无关字段放进同一个对象,任何字段变化都会扩大更新范围。可按职责拆分多个 Context,并用 useMemo 稳定包含函数的对象值,但不要在没有性能证据时过度优化。
Context 负责传递数据,不负责定义状态如何更新。复杂业务仍应把状态管理、请求和缓存逻辑放在清晰的 Hook 或专用状态层中,再通过 Context 暴露必要接口。