React 项目里该用 props 还是 context,判断依据是数据消费点与数据来源之间的距离,以及中间层是否真的需要使用这份数据。如果只有一到两层、父组件本来就在渲染子组件,用 props 传递更直接,类型推导、调试、单元测试都更省事;只有当同一份数据跨越多层、中间组件只“转发”而不使用它时,context 才值得引入。不要因为“以后可能会用到”就提前用 context 包裹整个应用。
先数三层:数据从哪来、谁真正读取、中间几层是否只是转发。一到两层且中间组件会用到数据,用 props,把数据作为组件对外接口,改动可追踪;跨三层以上且中间层完全不读取,再换成 context,并导出带兜底校验的自定义 hook,而不是直接暴露 context 对象。数据变化频繁(比如每次输入都会更新)或需要多实例隔离时,context 会放大重渲染范围,建议仍用 props 或配合拆分 context 与 memo,并在改造后用 DevTools Profiler 确认渲染范围。
先确认当前场景和目标
把这次改动目标写成一句话:是“让某个深层组件拿到数据”,还是“减少中间层被迫声明无用参数”。这两种目标对应的做法不同,前者关注数据怎么送到,后者关注组件接口怎么简化。动手前先确认这几件事:
- 数据消费点有几个:只有一处读取,通常不值得为它建立全局 context;多处读取同一份数据,context 的价值才会显现。
- 中间层是否要使用这份数据:中间组件只做透传(
<Child user={user} />这种一行接一行的写法)是 context 的典型场景;中间组件自己也要用,props 反而更清晰。 - 更新频率:主题、语言、登录用户这类变化不频繁的数据适合 context;表单输入、鼠标位置、滚动位置这类高频变化的数据,放进 context 会让所有消费组件跟着重渲染。
- 运行环境:是否需要服务端渲染、组件库是否会被别人以多个实例引入、是否有同页面多份 Provider 的需求,这些会影响 Provider 放在哪一层。
- 项目现有约定:团队已有状态库或全局 store,再引入一套 context 会增加两套数据源的同步成本,先确认是否可复用现有方案。
如果上面几条里,消费点不止一处、中间层纯透传、数据变化不频繁,context 是合理选择;否则先用 props,改造成本更低。

按这个顺序处理
- 先不改结构,用 props 写一版。把数据作为子组件的显式参数,确认数据流方向正确、类型可推导。这一步的目的是拿到对照基线,后面的验证要跟它对。
- 尝试用组件组合替代逐层传递。父组件把已经拿到数据的子组件作为 children 或 render 属性传入中间层,中间层就不需要知道数据是什么。这一步在很多“纯透传”场景里能直接解决问题,且不引入新的全局状态。
- 仍需要跨层共享时,再建 context。创建时不要直接 export context 本体,而是导出一个自定义 hook,把“必须在 Provider 内使用”的约束写在 hook 里,避免默认值掩盖漏包 Provider 的问题。
// UserContext.jsx —— 放在 src/contexts 或对应模块目录下
import { createContext, useContext } from 'react';
const UserContext = createContext(null);
export function UserProvider({ value, children }) {
return <UserContext.Provider value={value}>{children}</UserContext.Provider>;
}
export function useUser() {
const ctx = useContext(UserContext);
if (ctx === null) {
throw new Error('useUser 必须在 UserProvider 内使用');
}
return ctx;
}
替换项:value 由调用方传入,通常来自页面级容器的 state 或请求结果;null 只是哨兵值,如果你的业务数据本身可能为 null,需要换成一个独有对象作为默认值。放的位置要覆盖所有消费组件,一般是路由布局层或页面根组件,不要下沉到列表项里,否则每个列表项都会建一个 Provider。
如果一份 context 里既有变化很少的字段(登录信息)又有变化很频繁的字段(输入中的关键字),建议拆成两个 Provider,让高频变化的数据不影响低频消费组件的渲染范围。拆分成本不高,但比事后加 memo 更好排查。

改完后怎么验证
验证的核心是两件事:数据是否到位,渲染范围是否可控。可以按下面这些动作逐项确认:
- 功能验证:把 Provider 临时去掉,页面应当抛出你在 hook 里写的错误,而不是静默显示空数据;这说明兜底校验生效。
- 渲染范围验证:打开 React DevTools 的 Profiler,录制一次会改变 context 值的交互,看哪些组件被记录为重新渲染。预期信号是:真正使用这份数据的组件出现,纯中间层组件不出现或数量明显减少。如果中间层仍在大量重渲染,通常是消费点在中间层,或者 Provider 位置放得过高。
- 类型与静态检查:跑一遍项目的类型检查命令(如
tsc --noEmit),确认改用 context 后子组件不再需要预留可选的 props,接口没有变松。 - 测试覆盖:给使用该 hook 的组件补一个渲染测试,测试里用 Provider 包裹;如果测试直接渲染组件报错,说明该组件对 Provider 有隐性依赖,需要在组件文档或注释里写清楚。
这些检查只能说明“当前改动没有明显走偏”,不能替代对真实交互路径的手动走查。把关键的增删改操作各点一遍,比只看 Profiler 更可靠。
容易忽略的边界
- 高频更新不适合放 context:如果某个值每帧或每次输入都变,context 的传播成本会体现出来。此时优先考虑把状态留在最近的共同父组件,用 props 传一层,或把消费组件拆开单独订阅。
- 多实例与嵌套:同一页面里如果存在两个 Provider(比如左侧列表、右侧详情各自一份),内层会覆盖外层。需要隔离的场景要显式设计 Provider 位置,而不是依赖“最近的那个”。
- 服务端渲染与多次渲染:服务端渲染时 context 值只在单次请求内有效,不能跨请求复用模块级变量存放用户数据,否则会出现串号。
- 对外发布组件库时:context 会成为隐式接口,消费方必须按你的 Provider 结构包裹。若不希望绑定实现,对外仍用 props 暴露能力,context 只作为内部实现细节。
- 版本差异需要确认:不同 React 版本对 context 的默认值与 Provider 写法存在差异,涉及旧版本项目时,先确认项目实际使用的 React 版本和构建配置,再决定写法。
- 回退路径:改造后发现渲染范围失控或测试大面积失败,可以先回到 props 版本,把 context 收缩到真正跨层的那一两个字段,而不是整体推翻重写。