跳到正文

我所理解的前端框架最佳实践(7):合理使用全局状态

我所理解的前端框架最佳实践

  1. 用表格组件减少通用渲染和交互的维护成本
  2. 利用派生值减少维护成本和心智负担
  3. 正确拆分组件
  4. 抽取业务逻辑后,谁持有状态和副作用
  5. 按入口和依赖组织大型模块
  6. 用 kebab-case 格式统一文件名
  7. 合理使用全局状态(当前)

组件拆开后,父组件可能仍然很长。阅读区要让工具栏切换查找结果,让正文展开命中所在的章节,还要让侧栏定位批注。这些交互确实共享状态,逐项传递的 props 也确实会增加阅读负担。

把它们移进 store,可以省掉一部分接线,但还需要回答:现在打开两篇文章,它们会不会共用同一个查找词?关闭其中一篇,另一篇的高亮会不会被清除?决定状态放在哪里前,先确定哪些地方应该共享同一份值、这份值应该活多久,以及由谁负责更新和清理。

先确定共享范围,再选状态工具

「全局」至少涉及两个不同的问题:哪些代码能取得状态,以及运行时究竟创建了几份状态。模块导出一个工厂,许多组件都能导入这个工厂,却可以各自创建独立实例;模块直接导出一个可变对象,导入方通常会共享这个模块实例中的对象。

还要单独决定状态是否持久化。放进 store 不会自动让它跨刷新保存;写进本地存储也不会自动赋予它正确的应用级归属。

对于一个可以同时打开多篇文章的阅读工作台,可以先这样划分:

状态 合适的共享范围 生命周期与身份
一个对话框里的复制反馈 对话框内部 本次交互,关闭或重新打开时按规则重置
查找词、当前命中、批注草稿、对比开关 一个阅读会话及其子树 阅读标签或阅读区实例
当前工作区、共享索引进度、书签和目录缓存 工作区内的多个入口 当前窗口的工作区会话
主题、字号等用户设置 需要遵循这些设置的应用区域 应用或账号,可按需要持久化

这张表表达的是工作台的设计判断。某个产品要求多个阅读区同步查找词时,查找词也可以成为共同会话状态。共享范围应由行为决定。

Pinia 的入门文档把跨处使用和跨页面保留的数据列为 store 的适用对象,同时提醒局部数据可以留在组件里。Redux 的状态组织 FAQ 也要求结合其他区域是否关心它、是否需要缓存和恢复等条件判断,并认可组件局部状态。

状态库也可以管理一份局部会话

使用状态管理库,并不必然要求所有组件共享同一个应用单例。不同工具都提供了决定实例范围的办法,具体机制有所不同。

工具 官方资料中的组织方式 使用时需要确认的边界
Pinia 按 store 组织业务状态,在同一个 Pinia 实例中共享对应 store 同一 Pinia 下调用相同 store 不会为每个阅读组件各建一份状态;SSR 要隔离不同应用或请求的实例
Vuex 单一状态树可以分成包含 state、getter、mutation 和 action 的模块 模块命名空间组织名字;模块复用还需要状态工厂和明确的注册路径
Zustand 可以用 vanilla store 工厂创建实例,再由 React Context 提供给子树 在会话挂载时稳定创建实例,避免把多个阅读区接到同一个模块单例
Jotai atom 描述与实际值分离,值保存在 store 中,由 Provider 提供 多个 Provider 可以隔离子树;省略 Provider 时会使用默认 store
Redux 应用共享状态集中在 store,局部 UI 可以继续使用组件状态 先判断是否需要应用级共享,再设计 reducer、selector 和订阅范围
MobX 可以按领域数据与 UI 状态组织 store,也可以通过 Context 提供 observable 实例 observable 可以从 props、Context 或模块取得,传递方式和实例范围需要分别决定

这几种机制分别见 Pinia 的实例说明、Vuex 的模块与复用、Zustand 的 props 初始化指南、Jotai 的 Provider 文档源码、Redux 的风格指南和 MobX 的 React 集成。Vuex 的入口说明目前建议新项目使用 Pinia,现有 Vuex 项目仍可按原有模块边界维护。

如果确实需要子树共享,一个 Vue 阅读区可以在自身挂载时建立会话状态,再通过 provide / inject 交给内部业务组件。React 也可以用 Context 提供本次创建的 Zustand store 或 MobX 对象,或者给子树配置独立的 Jotai Provider。这里解决的是一个业务子树内的共享,生命周期仍可以跟随该子树。

提供和读取的规则也要清楚。Vue 的依赖注入文档建议把响应式状态的修改集中在提供者;需要由后代触发更新时,可以一并提供动作。React 的 Context 指南则提醒先考虑明确的 props 和组件组合。Context 改变数据到达消费者的路径,状态仍然需要一个创建者和更新者。

省去透传,也会省去显式依赖

在父组件写 :query="query" 和 @next="nextMatch",读者能直接看到子组件需要什么。换成注入后,这份依赖要进入子组件、组合函数乃至更深的文件才能找到。组件移动到另一个宿主时,也可能因为缺少提供者而失效。依赖清单变得不直观,是选型时需要接受的代价。

Vue 的注入规则还规定,同一个 key 存在多个提供者时,消费者取得最近祖先提供的值。嵌套会话因此可以隔离状态,但新增一层提供者也会改变后代取得的实例。仅查看一个 inject(key),无法知道运行时最终对应哪个宿主。

具名、带类型的 InjectionKey 能检查接口形状;useReadingSearchContext() 这样的窄入口能让搜索依赖更容易检索。消费方显式解构 query、matchCount 和 nextMatch,也比访问整份 session 更清楚。不过,这些措施仍不能恢复父子调用处完整的字段连线,需要结合引用搜索或跨文件扫描检查消费者。

因此,选择注入前先指出它究竟省去了哪些重复的中间层,以及这些组件为何应共享同一个实例。只有一层转交、通用 UI 控件,或必须明确联系某个宿主的 DOM 节点与回调,通常继续用 props 更容易判断归属。确需注入时,按职责提供只读状态和具名动作,消费方保持 ref,并让缺少必需提供者的情况明确失败。静默建立一个模块单例作为默认值,会把缺失依赖变成跨实例共享,反而更难发现。

共享状态需要明确的更新和清理规则

选定共享范围后,我会先检查下面几件事。

源状态保持一份。文档快照已经由工作台持有时,阅读会话可以引用它、派生解析结果。再复制一份快照到 store,并用 watcher 双向同步,会增加冲突和过期数据的处理路径。可以重新算出的结果优先派生,相关原则也适用于 Redux 的 selector。

动作表达业务意图。子组件请求「跳到下一个命中」时,负责搜索的模块统一更新当前下标、展开章节并滚动正文。把可写字段交给各处任意拼接更新,仍然需要读者逐个寻找谁维护了这些不变量。Pinia 允许直接修改状态;是否要求通过业务 action 更新,是项目为了维护跨字段规则作出的约定。

实例身份与资源身份分开。文档路径标识文件,阅读标签 ID 标识一次会话。同一篇文章可能打开两次,分别具有滚动位置、草稿和对比基线。如果会话状态存在公共容器里,至少要先说明按什么身份分区、何时建立和释放。只按文档路径保存全部 UI 状态,会让两个会话互相覆盖。

异步结果仍要校验归属。查询发出后切换了文档、工作区或基线,旧响应不能覆盖新状态。状态移入 store 后,这个问题依然存在。校验需要考虑请求版本以及实际发生变化的会话身份,关闭后也要取消订阅或使结果失效。

持久化只保存需要恢复的数据。书签、阅读位置和用户设置可以形成稳定的数据契约。DOM、Range、编辑器实例和定时器等运行时资源,应由创建它们的会话或组件管理。Redux 对可序列化状态有明确建议;MobX 等工具也能管理类实例,所以这里不能把某一库的序列化约束推广成所有状态工具的能力限制。

服务端或磁盘上的数据还需要缓存和更新规则。Redux 官方的 RTK Query 教程专门区分了取数缓存与客户端状态管理。对于本地文档工作台,同样需要决定什么时候重新读取磁盘、怎样识别版本,以及多个入口是否共用一次请求。仅把响应放进一个全局变量,无法替代这些决定。

阅读标签和正文实例有不同的生命周期

同一个窗口里,工具栏要知道当前操作哪个标签,阅读区要排布左右两栏,文档导航又要更新相应标签的历史。三处使用的是同一组标签、活动标签 ID 和对读关系。关闭一个标签时,活跃标签和对读关系可能都要更新,因此由同一个阅读会话 Store 持有 views、activeId 和 split,也在这里定义移除标签和结束对读的动作。

App 和阅读区各自读取所需的 Ref 与动作。原来传给阅读区的三个会话 prop 可以去掉,关闭标签和结束对读在阅读区调用会话动作。关闭前仍由阅读区确认未提交的草稿并保存位置。点击另一个标签时,窗口先确认是否能切换,保存离开前的位置,然后更新活动标签。恢复对读和用户点标签共用这条切换流程。

每个正文实例仍接收自己的文档快照、基线和定位请求。左右栏各有 DOM、焦点和滚动位置,阅读区按标签 ID 管理这些实例。异步保存结果用发起操作的标签写回,切换到另一栏以后也能更新原文档。内存里的 split 记录运行时标签 ID,换工作区时随会话重置。「继续对读」保存的是文档路径和活动侧,下次打开时可以据此恢复。进入设置页只隐藏阅读区,两个实例仍留在原处。

已有工作区 Store 也能减少转交。设置页原来把工作区路径和偏好传给工作区设置组件,实际是后者初始化表单草稿,并且它已经直接读取 Store 的索引状态。工作区设置可以从同一个 Store 获取路径和偏好,修改时仍通过事件请求保存。独立与内嵌的仓库工具也直接读取同一份偏好,文档路径、打开模式和可见性继续由调用方决定。

静态检查能找线索,状态归属还需要审阅

lint 可以追踪具体语法事实,例如:组件是否只把某个 prop 原样传给后代,某次 composable 调用的返回值是否全部流向一个私有子组件,模块顶层是否创建并导出了可变响应式对象。这些证据可以分别帮助发现深层透传、局部逻辑候选和隐式共享状态。

检测深层透传需要读取多个 SFC 的调用关系,并处理别名、插槽、条件挂载和动态组件。字段用途与组件生命周期也不总能从静态语法推断出来。因此,提示应列出来源、经过的组件、实际消费位置和无法解析的边,不直接要求「迁到全局 store」。

本地的 inspect-vue-prop-consumption.ts 先扫描项目一次,解析相对导入、显式 barrel、toRefs 别名、具名 composable 参数和 model,再输出 JSON 与逐字段 MD。每条边保留绑定位置、表达式和模板条件,读者可以从清单进入源码复核。CSS v-bind() 也是消费;模板循环中的同名变量则属于局部作用域,不算组件 prop。外部包、未展开类型、整体对象传递和循环边保留为未知。

在阅读工作台的改前清单里,工作区路径和偏好都出现在 SettingsPage 的 passThrough 字段。迁移后这两项消失。工具栏 Teleport 的三个目标节点在阅读区仍属于原样转交,保留它们可以从调用点看到每个挂载目标。阅读会话的三个 prop 原先都参与了计算或脚本调用。用静态清单定位消费后,还要核对它们的写入动作和重置条件。

这里有两个容易混淆的边界。首先,某个 composable 接收了 snapshot,不代表它的每个返回值都依赖整份快照;输入消费与返回值来源分别记录。其次,组件完整代码包含某个消费者,不代表当前固定模式会运行它。模板分支、惰性 computed、watch 和事件入口仍需结合实际挂载检查。否则可能把多模式组件其他页面才需要的输入,也当成阅读区必须共享的状态。

四条组件边界规则默认进入 Vue 预设,用真实私有调用、私有组件标签和消费关系判断适用性;跨 SFC 的消费清单先作为项目审阅脚本。等项目确定了共享协议,再检查注入入口的导入边界、UI 是否依赖上层会话,以及缺少提供者时是否偷偷创建单例。跨文件迁移会改变实例数、挂载条件和清理时机,因此不提供自动修复。

ESLint 的 no-restricted-imports 可以保护已经确定的导入边界,dependency-cruiser 可以检查文件依赖和禁止方向,Redux Toolkit 的序列化中间件检查运行时状态。它们各自验证的是具体规则,不能证明一个状态应当共享给哪些业务实例。对于已经选定的阅读会话设计,可以再补「叶子业务组件从会话读取能力,通用 UI 不导入会话模块」等可确定的规则。

开发新区域时,先确定状态的消费者、写入动作、实例身份和销毁条件,再选择 props、子树注入或应用 store。修改后检查同一文档双开、两个阅读区各自操作、关闭重开、换稿以及旧请求晚到的行为。这些路径通过后,省下来的接线才有明确的维护收益。