Vue中ref变量跨组合式函数安全共享的关键是共用同一ref实例，需避免解构丢失响应性、多实例误判等陷阱，推荐顶层定义、useSharedRef封装或provide/inject注入。
Vue 中 ref 变量在多个组合式函数间安全共享状态，关键在于“共用同一 ref 实例”，而非各自创建副本。只要所有函数访问的是同一个响应式引用，就能实现自动同步更新。这不需要 Pinia，但需避开常见陷阱，比如解构丢失响应性、多实例误判、或隐式耦合。
把 ref 定义在模块顶层（最直接）
适合状态简单、作用域明确的场景（如开关、计数器、搜索关键词）。将 ref 导出为命名常量，各组合式函数直接导入使用：
- 新建 shared-state.ts：
import { ref } from 'vue'<br>export const searchKeyword = ref('') - 在 useSearchFilter() 和 useSearchHistory() 中都导入并读写
searchKeyword.value - 修改任一函数都会触发另一函数中依赖该 ref 的计算属性或副作用更新
封装成 useSharedRef() 组合式函数（推荐）
比裸导出 ref 更可控，能统一初始化逻辑、添加校验、防抖或日志，且天然支持 TypeScript 类型推导：
vue-component-analyzer
下载
递归分析 Vue 项目组件依赖，从入口文件生成组件层级图，支持 Vue 2/3，输出组件名、文件路径和属性。适用于分析组件结构、排查依赖或了解项目架构。
- 定义 useSharedRef.ts：
import { ref, Ref } from 'vue'<br>export function useSharedRef<T>(initial: T): Ref<T> {<br> return ref(initial)<br>} - 在多个组合式函数中调用同一实例：
const countRef = useSharedRef(0) // 注意：必须只调用一次，然后复用这个 ref - 更实用的做法是返回一个带方法的对象：
export function useCounter() {<br> const value = ref(0)<br> const increment = () => value.value++<br> return { value, increment }<br>}
多个组件调用useCounter()会得到独立副本；若要共享，就应在顶层调用一次，再传入各组合式函数
配合 provide/inject 在组件树中注入 ref（适合嵌套协作）
当状态由父组件控制、需向下穿透多层子组件（如表单上下文、编辑模式开关），且不希望污染全局命名空间时适用：
立即学习“前端免费学习笔记（深入）”；
- 父组件 setup 中：
const editing = ref(false)<br>provide('editingRef', editing) - 任意子组合式函数中：
import { inject } from 'vue'<br>const editingRef = inject('editingRef') as Ref<boolean> - 注意：inject 必须在 setup 顶层执行；不能在条件分支或异步回调里调用；类型断言不可省略
避免踩坑的关键细节
ref 共享看似简单，但几个细节决定是否真正“安全”：
- 禁止解构 ref：`const { value } = searchKeyword` 会丢失响应性，始终通过 `.value` 访问
- 区分“共享”与“复用”：`useCounter()` 每次调用生成新 ref；要共享就得提前创建好，再作为参数传入各组合式函数
-
按功能域拆分 ref：不要堆一个 giant shared ref，而是按业务划分，如
useAuthRef()、useCartRef()，降低耦合风险 - 避免循环依赖：两个共享 ref 的 setter 不要互相触发，否则可能引发无限更新
