triggerRef仅对shallowRef生效，用于手动触发其内部属性修改后的响应式更新；需传入shallowRef实例本身，而非.value或普通对象。
shallowRef 不是“浅拷贝”，而是“浅响应”——它只让 .value 这一层具备响应性，内部对象本身不被 Proxy 代理。当你修改 state.value.obj.field 或 state.value.list[0].done 时，Vue 根本监听不到，视图自然不更新。此时必须用 triggerRef 手动“敲钟”，通知依赖重新执行。
什么时候非用 triggerRef 不可
满足两个条件就该用：
- 你用了
shallowRef包裹一个对象或数组 - 你没替换整个
.value，而是直接改了它内部的某个属性、某个数组项、或调用第三方方法（如three.scene.add()）改变了其状态
比如：config.value.timeout = 5000、canvasState.value.width += 10、items.value[2].selected = true——这些操作后，视图静默不动，就是 triggerRef 的典型上岗时刻。
正确写法：改完立刻传 shallowRef 本身
关键就两步，顺序不能错：
- 先修改
.value内部内容（任意方式） - 紧接着调用
triggerRef(你的shallowRef变量)
✅ 正确示例：
import { shallowRef, triggerRef } from 'vue'
<p>const user = shallowRef({ name: '小明', score: 85 })
user.value.score = 92 // 修改内部
triggerRef(user) // 传 user，不是 user.value❌ 常见错误：
-
triggerRef(user.value)→ 参数类型错误，会警告 -
triggerRef(ref({}))→ 对普通 ref 调用，无效且静默忽略 -
triggerRef(reactive({}))→ 完全不支持，别试
配合 markRaw 处理第三方实例更稳妥
对 Canvas、Three.js 场景、Map/Set 等本就不该被响应式代理的对象，推荐组合使用：
- 用
markRaw告诉 Vue “别碰这个对象” - 再用
shallowRef包一层，保持引用稳定 - 修改其属性后，调
triggerRef触发更新
例如：
import { shallowRef, triggerRef, markRaw } from 'vue'
import * as THREE from 'three'
<p>const scene = shallowRef(markRaw(new THREE.Scene()))
scene.value.background = new THREE.Color(0x222222) // 直接改
triggerRef(scene) // 视图中依赖 scene 的部分立即重算不需要 triggerRef 的情况要分清
别把 triggerRef 当万能刷新键：
- 你用的是
ref或reactive→ 内部改属性自动更新，不用它 - 你替换了整个
.value（如state.value = { ... }）→ Vue 自动追踪，也不用它 - 你在异步回调里改完忘了调用 → 视图卡住，检查是否漏了那一行
triggerRef(xxx)
它只解决一个具体问题：shallowRef 的内部变更如何被响应式系统感知。精准、轻量、不可替代。
