watcheffect依赖遗漏最常见原因是条件分支中响应式数据未在首次执行时被访问，导致未建立依赖；需确保首次执行覆盖所有分支、避免响应式访问藏于未执行代码、用computed收口逻辑、调试时临时修改初始值验证。
watchEffect 依赖遗漏最常见的情况，就是条件分支里读取了响应式数据，但该分支在首次执行时没走通，导致 Vue 根本没“看到”它——也就不会建立依赖关系。
检查首次执行是否覆盖所有分支路径
watchEffect 一注册就会立即执行一次。只有这次执行中实际访问到的响应式属性，才会被纳入依赖列表。如果某个值只在 if (searchQuery.value) 块里被读取，而初始时 searchQuery.value 是空或 false，那这个值就永远不会被追踪。
- 打开控制台，在 watchEffect 回调开头加 console.log('run')，确认它确实执行了
- 打印关键响应式变量的初始值，比如 console.log({ searchQuery: searchQuery.value, page: page.value })
- 确保至少有一次执行能进入你期望的分支；否则依赖压根不会建立
避免把响应式访问“藏”在未执行的代码块里
以下写法看似合理，实则危险：
- if (showDetails) { user.profile.city } —— 如果 showDetails 初始为 false，user.profile.city 就不会被收集
- const data = apiResponse?.items || [] —— 若 apiResponse 是 ref，但 ?.items 访问发生在空值时，整个链路可能中断
- 函数封装后调用：formatName(user)，而 formatName 内部读取 user.firstName —— watchEffect 看不到这个读取，依赖丢失
用 computed 提前收口动态逻辑
当是否读取某个值由多个条件共同决定时，不要让 watchEffect 直接面对复杂分支。先用 computed 把逻辑“固化”成一个明确的响应式信号：
- 定义 const shouldLoadProfile = computed(() => userId.value && isMounted.value)
- watchEffect 中只读 shouldLoadProfile.value 和 userId.value
- 这样依赖清晰、可预测，也方便调试：只要 computed 更新，watchEffect 就会响应
调试时主动触发依赖收集
临时修改初始值，让所有分支都跑一遍，是最快验证依赖是否齐全的方法：
- 把 searchQuery.value = 'test' 放在 setup 开头，强制走搜索分支
- 用 Vue Devtools 的 “Reactivity” 面板查看当前 watchEffect 实际追踪了哪些字段
- 观察控制台 log 是否随预期字段变化而触发，不触发就说明它没在依赖列表里
