在 watchEffect 中同步操作 localStorage 必须手动 try/catch，因其抛出的 QuotaExceededError 等异常不会被自动捕获；需配合 ref 状态反馈错误，并避免修改所依赖的响应式源以防无限循环。
在 watchEffect 中同步执行本地存储（如 localStorage）操作时，异常不会自动被捕获——因为 localStorage 的读写是同步的，但可能抛出 QuotaExceededError、SecurityError 等原生错误，而 watchEffect 本身不提供错误边界或自动 try/catch。必须手动包裹操作并处理错误。
本地存储操作需显式 try/catch
watchEffect 只负责响应式依赖追踪和副作用执行，不介入错误控制流程。localStorage 方法（如 setItem、getItem）失败时会直接抛出同步异常，若未捕获，将中断当前 watchEffect 执行，并可能向上冒泡至 Vue 错误处理器或全局 window.onerror。
- 所有 localStorage 操作必须包裹在
try...catch块中 - 避免在 catch 后静默吞掉错误；应记录日志、降级处理（如改用内存缓存），或更新 UI 状态提示用户
- 注意：不能依赖
await或 Promise 包装 localStorage —— 它是同步 API，包装成 Promise 不解决异常捕获问题，反而增加冗余
结合 ref 状态反馈错误信息
推荐用响应式变量暴露存储状态，便于模板或逻辑消费：
- 定义
const saveStatus = ref<'idle' | 'success' | 'error'>('idle')和const errorMsg = ref('') - 在
watchEffect内部写入前设为'idle'，成功后设为'success'，失败则设为'error'并赋值具体消息 - 这样模板中可用
v-if="saveStatus === 'error'"显示提示，且不影响其他响应式逻辑
避免触发无限循环
如果 watchEffect 依赖某个 ref，又在内部修改该 ref（比如保存后更新本地副本），需警惕自我触发：
Ainative Vue Sdk
下载
使用 `@ainative/vue-sdk` 为 Vue 3 应用添加 AI 聊天功能。适用于以下场景：(1) 安装 `@ainative/vue-sdk`，(2) 在 Vue 组件中使用 `useChat` 组合式函数，(3) 提供……
立即学习“前端免费学习笔记（深入）”；
- 不要在 watchEffect 中直接修改它所追踪的响应式源（例如
watchEffect(() => { localStorage.setItem('x', state.value); state.value = ... })） - 如确需更新状态，建议分离「触发源」与「存储目标」，或使用
watch替代（更明确依赖关系） - 必要时加守卫条件，如
if (state.value !== cachedValue)再执行写入
完整示例：安全保存搜索关键词
以下是一个典型场景：关键词变更时自动存入 localStorage，并反馈结果：
const keyword = ref('')
const saveStatus = ref('idle') // 'idle' | 'success' | 'error'
const saveError = ref('')
watchEffect(() => {
if (!keyword.value.trim()) return
try {
localStorage.setItem('lastSearchKeyword', keyword.value)
saveStatus.value = 'success'
saveError.value = ''
} catch (err) {
console.warn('Failed to save to localStorage:', err)
saveStatus.value = 'error'
saveError.value = err instanceof DOMException
? `Storage error: ${err.name}`
: 'Unknown storage failure'
}
})
这段代码确保每次 keyword 变化都尝试持久化，且任何异常都被拦截、分类、可视化——不打断响应式流程，也不污染全局环境。
