必须手动触发响应更新的情况仅限于：shallowRef内部属性被修改、第三方库绕过Vue setter修改shallowRef对象、shallowReactive内部修改需换用shallowRef+triggerRef；triggerRef仅作用于shallowRef实例本身，调用后立即通知依赖更新。
Vue 响应式数据的更新通常自动发生，但某些场景下需要手动干预——核心在于理解“谁被追踪”和“谁没被追踪”。真正需要手动触发的情况，集中在 shallowRef 修改内部属性、或响应式系统未覆盖的赋值操作上，而不是随便调用就能刷新视图。
什么时候必须手动触发？
只有以下情况 Vue 不会自动响应，才需主动通知：
- 用 shallowRef 包裹对象后，直接改
.value.name、.value.list[0].id这类深层字段 - 用第三方库（如 Lodash 的
set()、Three.js 的属性赋值）修改了 shallowRef 内部对象，绕过 Vue 的 setter - 对 shallowReactive 对象做了内部修改——但它没有配套的 trigger API，只能换用
shallowRef + triggerRef方案
triggerRef：专为 shallowRef 设计的手动通知机制
triggerRef 不改变数据，只“敲钟”告诉依赖：这个 shallowRef 的值变了，请重新执行。它只接受一个参数：shallowRef 实例本身。
vue-component-analyzer
下载
递归分析 Vue 项目组件依赖，从入口文件生成组件层级图，支持 Vue 2/3，输出组件名、文件路径和属性。适用于分析组件结构、排查依赖或了解项目架构。
- ✅ 正确：
triggerRef(userInfo)（userInfo是shallowRef({ name: '张三' })创建的） - ❌ 错误：
triggerRef(userInfo.value)、triggerRef({})、triggerRef(refObj) - ⚠️ 注意：修改完内部属性后立即调用，顺序不能颠倒；仅替换整个
.value（如data.value = { a: 2 }）时，无需 triggerRef
其他手动更新方式及适用边界
不是所有“想刷新”的场景都该用 triggerRef：
立即学习“前端免费学习笔记（深入）”；
-
$forceUpdate()：强制重渲染当前组件，跳过响应式依赖检查，适合极少数调试或 DOM 状态异常时使用，生产环境慎用 -
Vue.set()或set()（Vue 3 中为reactive对象新增属性）：解决“对象新增属性不响应”的问题，仅适用于 reactive/ref，不适用于 shallowRef - 修改 props 或顶层 ref / reactive 数据：只要在响应式系统内变更，Vue 自动更新，无需手动干预
避坑提醒
几个高频误区：
- 别对普通对象、ref、reactive 调用
triggerRef——静默失败，无报错也无效果 - 不要在模板中绑定
triggerRef，它是逻辑层控制手段，应在事件处理或副作用函数中调用 - 从 shallowRef 解构出 toRef 后再修改，仍要对原始 shallowRef 调用
triggerRef，不能作用于 toRef
