# vueuse/vueuse `@vueuse/shared` **版本：** 14.2.1（2026 年 2 月） **标签：** 下一个：5.0.0（2021 年 6 月），alpha：14.0.0-alpha.3（2025 年 9 月），beta：14.0.0-beta.1（2025 年 9 月），最新：14.2.1（2026 年 2 月） **参考文献：** [文档]() — API 参考、指南 ## API 变更本节记录了特定于版本的 API 更改 - 优先考虑最近的主要/次要版本。 * 重大突破：需要 Vue 3.5 - v14 现在需要 Vue 3.5+ 才能进行本机性能优化 [来源]() * 突破： `useThrottleFn` 对齐 — v14 与传统节流行为对齐（默认情况下前导：true，尾随：false）[来源]() * 重大突破：仅限 ESM — v13 放弃了 CJS 构建支持，软件包现在仅限 ESM [来源]() * 重大：`createSharedComposable` 返回 - v14 现在仅返回客户端的共享可组合实例 [来源]() * 新功能： `refManualReset` — v14 中的新函数，用于使用显式 `reset()` 方法创建引用 [来源]() * 新功能：“watchAtMost”控件 - v14 在返回值中添加了“pause”、“resume”和“count”[来源]() * 新功能： `tryOnScopeDispose` — v14 添加了可选的 `failSilently` 参数来抑制超出范围的错误 [源]() * 新功能： `useArrayReduce` 类型 — v14.1.0 现在导出 `UseArrayReduceReturn` 类型 [源]() * 新：`compulatedWithControl` 源 — v14.1.0 允许监视源数组中的不同类型 [源]() * 已弃用： `compulatedEager` — v14 已弃用，转而采用 Vue 3.5 的原生 `compulated` 优化 [来源]() * 已弃用： `watchPausable` — v14 已弃用，取而代之的是 Vue 的内置 `watch` 或 `pausableFilter` [来源]() * 已弃用：别名导出 — v14 弃用了辅助名称，如 `ignorableWatch`，转而使用主要的 `watchIgnorable` [来源]() * 已弃用： `eagerCompulated` — v14 已弃用别名，改用 `compulatedEager` [来源]() * 已弃用： `controlledCompulated` — v14 已弃用别名，改用 `compulatedWithControl` [来源]() **还更改了：** `createReactiveFn` 已弃用 · `autoResetRef` 已弃用 · `debouncedRef` 已弃用 · `useDebounce` 已弃用 · `throttledRef` 已弃用 · `useThrottle` 已弃用 · `controlRef` 已弃用 · `debouncedWatch` 已弃用 · `ignorableWatch` 已弃用 · `pausableWatch` 已弃用 · `throttledWatch` 已弃用 ## 最佳实践 * 更喜欢 Vue 3.4+ 内置的“compulated()”而不是“compulatedEager()”——标准计算属性现在仅在返回值实际发生变化时才会触发依赖项，从而无需急切求值 [来源]() * 使用 createSharedComposable() 进行 SSR 安全状态共享 - 它在 SSR 期间自动回退到非共享实例，以防止交叉请求状态污染，同时在客户端上保持单例[来源]() * 使用`provideLocal()`和`injectLocal()`在同一组件内共享状态 - 允许访问提供的值而无需通过父/子边界，现在具有完整的Vapor模式支持[源]() * 将手动观察者替换为一次性异步条件的“until()”——提供基于承诺的 API，用于流量控制，一旦引用满足特定要求，就会解析，从而减少回调嵌套 // 首选一次性触发器等待直到(isReady).toBe(true) 做某事（） * 实现 `refManualReset()` 以便轻松恢复状态 - 提供内置的 `.reset()` 方法将引用返回到其初始值，非常适合清除表单或重置为默认过滤器[来源]() * 使用 `reactify()` 将普通实用函数转换为反应式函数 - 自动接受 refs 作为参数并返回 `ComputedRef`，从而实现反应式逻辑的快速开发 [源]() * 使用 `peek()` 和 `lay()` 通过 `refWithControl()` 优化热路径 — 允许读取或写入 ref 的值，而不触发反应性系统或跟踪依赖项，从而最大限度地减少不必要的更新 * 通过 `makeDestructurable()` 返回双重对象/数组 API — 通过允许用户在位置（数组）或命名（对象）解构之间进行选择，使您的自定义可组合项更加灵活 * 在与 `syncRef()` 自定义转换同步期间转换状态 - 使用 `ltr` 和 `rtl` 函数的 `transform` 选项来映射不同类型的引用之间的值 [源]() // 将数字引用与字符串引用同步同步引用（计数，字符串计数，{ 变换：{ ltr：左=>字符串（左）， rtl: 右 => 数字（右） } }) * 选择 `createGlobalState()` 来实现应用程序范围内的持久单例 - 与订阅者达到零时处理状态的共享可组合项不同，全局状态在整个应用程序生命周期中保持活动状态 [来源]()

查看共享技能

包含技能