shallowRef仅对.value整体赋值触发响应，不监听内部属性修改；适合坐标整体替换场景，如地图拖动获取新对象；频繁修改x/y需改用ref、reactive或拆分为多个ref。
shallowRef 本身不处理频繁更新，它只让 .value 的整体赋值触发响应式更新，对内部属性（比如 x、y）的修改完全不监听。所以直接用 shallowRef({ x: 0, y: 0 }) 存坐标，再反复改 pos.value.x++，视图根本不会刷新——这不是 bug，是设计如此。
适合场景：坐标数据只整体替换，不深层修改
如果你的坐标更新方式是“一次性换新对象”，比如地图拖动后拿到全新经纬度、传感器每秒推送一个新坐标对象，那 shallowRef 就很合适：
- 避免对每个坐标点做深度代理，省下大量 Proxy 开销
- 内存占用低，尤其在高频率（如 60fps）更新时更稳定
- 配合
watch或onBeforeUpdate可精准控制渲染时机
示例：
Ainative Vue Sdk
下载
使用 `@ainative/vue-sdk` 为 Vue 3 应用添加 AI 聊天功能。适用于以下场景：(1) 安装 `@ainative/vue-sdk`，(2) 在 Vue 组件中使用 `useChat` 组合式函数，(3) 提供……
// 每次更新都用新对象，触发响应
position.value = { x: newX, y: newY }
不适合场景：需要实时响应 x/y 单独变化
如果业务逻辑中频繁执行类似 position.value.x += 0.001 这样的细粒度更新，shallowRef 就失效了。此时有更匹配的方案：
立即学习“前端免费学习笔记（深入）”；
- 用 ref 包裹简单对象：Vue 会自动对其深层属性做响应式处理，适合中小规模、更新不极端的坐标流
-
用 reactive 管理坐标对象：语义更清晰，模板中可直接写
{{ pos.x }}，无需 .value -
拆成两个 ref：如
const x = ref(0)、const y = ref(0)，各自独立响应，更新粒度最细
高频坐标更新的实用建议
真正影响性能的往往不是响应式类型，而是更新频率和渲染节奏：
- 用
requestAnimationFrame或节流（如 Lodash 的throttle）控制坐标更新频率，避免每毫秒都触发 - 把坐标计算和 DOM 渲染解耦：用
shallowRef存原始数据，用computed派生渲染所需格式，避免重复计算 - 若坐标来自第三方库（如 MapLibre、Leaflet），优先用
shallowRef接收实例本身，而不是试图把它变响应式
