React / 系统课时
Context 管理共享状态
Context 管理共享状态
当主题、语言或当前用户等数据需要穿过多层组件时,逐层传递 props 会让中间组件承担无关参数。Context 可以把这类简单共享状态放到一个 Provider 中,再通过自定义 Hook 暴露统一读取接口。本课将完成一个可运行的主题状态示例,并明确 Context 的适用边界。
学习目标
- 使用
createContext、Provider 和useContext建立共享状态 - 用自定义 Hook 封装 Context 的读取与错误检查
- 判断哪些状态适合 Context,哪些高频或复杂状态不应直接塞进同一个 Context
Context 如何把状态送到组件树中
Context 的关键不是“全局变量”,而是Provider 为它下面的一棵组件子树提供值。消费者读取的是距离自己最近的同类 Provider,因此同一个 Context 也可以在不同子树中提供不同值。

Provider 决定共享范围,因此通常应把它放在“所有消费者的最近共同祖先”附近,而不是习惯性地放到整个应用最顶层。这样可以避免不相关组件也进入同一状态边界。
用 Provider 保存共享主题
下面的示例把主题状态保存在 ThemeProvider 中,并定义 useTheme 作为唯一读取入口。消费者不需要直接接触 ThemeContext,以后即使实现方式变化,也只需要修改 Provider 和 Hook。
import {
createContext,
useCallback,
useContext,
useMemo,
useState,
} from 'react';
const ThemeContext = createContext(null);
function ThemeProvider({ children }) {
const [theme, setTheme] = useState('light');
const toggleTheme = useCallback(() => {
setTheme((current) => (current === 'light' ? 'dark' : 'light'));
}, []);
// 保持 value 引用稳定,避免 Provider 因无关渲染产生新的对象。
const value = useMemo(
() => ({ theme, toggleTheme }),
[theme, toggleTheme],
);
return (
<ThemeContext.Provider value={value}>
{children}
</ThemeContext.Provider>
);
}
function useTheme() {
const context = useContext(ThemeContext);
// 把缺失 Provider 的错误集中在 Hook 中处理。
if (context === null) {
throw new Error('useTheme 必须在 ThemeProvider 内使用');
}
return context;
}
function Toolbar() {
const { theme, toggleTheme } = useTheme();
return (
<section>
<p>当前主题:{theme}</p>
<button onClick={toggleTheme}>切换主题</button>
</section>
);
}
function ProfilePanel() {
const { theme } = useTheme();
return <p>个人资料区域使用 {theme} 主题</p>;
}
export default function App() {
return (
<ThemeProvider>
<Toolbar />
<ProfilePanel />
</ThemeProvider>
);
}预期结果:页面初始同时显示“当前主题:light”和“个人资料区域使用 light 主题”。点击“切换主题”后,两处文本一起变为 dark;再次点击恢复为 light。
自定义 Hook 为什么值得保留
组件当然可以直接调用 useContext(ThemeContext),但项目一旦变大,这种写法会把 Context 的实现细节散落到所有消费者中。useTheme 提供了更稳定的调用面,并且能够统一检查组件是否忘记包裹 Provider。
自定义 Hook 还可以在以后增加派生值、日志或其他约束,而消费者继续只调用 useTheme()。这不是为了减少一行代码,而是为了把“如何取得主题状态”集中到一个地方。
控制 Context 的更新范围
Provider 的 value 变化时,读取该 Context 的消费者会重新渲染。因此,不要把主题、实时输入、动画进度、巨大业务对象等完全不同且更新频率不同的数据塞进一个 Context。
对于彼此独立的数据,可以拆分为多个 Context,例如 ThemeContext 和 UserContext。如果某份状态每秒频繁变化、拥有大量消费者,或者需要按字段精细订阅,单纯 Context 往往会带来过大的渲染范围,此时应重新设计状态边界或使用支持选择性订阅的状态方案。
Context 适合解决什么问题
Context 最适合“很多后代都需要、但变化相对可控”的共享数据,例如主题、语言、当前登录用户信息和应用级配置。只被两个相邻组件使用的状态仍然优先提升到共同父组件;只被单个组件使用的状态继续保持局部。
因此,使用 Context 的判断标准不是“这个值很重要”,而是“这棵组件子树中的多个位置都需要同一份数据,而且逐层传递已经降低可读性”。把 Provider 放在真正需要共享的范围附近,再通过自定义 Hook 暴露接口,通常就能保持清晰而可维护的数据流。