关键在于用 localStorage + storage 事件监听实现跨标签页同步：登录时写入 token，退出时 removeItem 触发其他标签页的 storage 事件并登出；配合 pinia-plugin-persistedstate 实现刷新自动恢复；需注意监听时机、token 写入完整性及 KeepAlive 缓存清理。
Vue 3 中实现多标签页同步登录与退出状态，关键在于让所有打开的标签页感知到同一份登录凭证的变化。仅靠 Pinia 或 Vuex 的内存状态无法跨 Tab 共享，必须借助浏览器级的存储机制和事件监听能力。
用 localStorage + storage 事件监听实现同步
这是最常用、兼容性好、无需额外通信通道的方案。原理是：所有标签页共享同一个 localStorage；当一个标签页修改 token（如退出时删掉），其他标签页会触发 storage 事件。
- 登录成功后，把 token 写入
localStorage.setItem('token', 'xxx')，同时用 Pinia 存一份用于响应式更新 - 退出时，先调用后端登出接口，再执行
localStorage.removeItem('token')（注意：必须写操作才会触发 storage 事件） - 在每个标签页的入口（如 main.ts 或 App.vue 的 onMounted）中监听 storage 事件：
window.addEventListener('storage', (e) => {
if (e.key === 'token' && !e.newValue) {
// 检测到 token 被清空，主动登出当前页
useUserStore().logout();
}
}); - 注意：storage 事件不会在触发修改的当前页面触发，只通知其他同源页面 —— 这正是我们想要的行为
配合 Pinia 持久化插件自动恢复状态
单个标签页刷新后，需要从 localStorage 自动还原登录态，避免白屏或跳转登录页。
- 使用
pinia-plugin-persistedstate，配置 user store 启用持久化：
export const useUserStore = defineStore('user', {
state: () => ({ token: '', userInfo: null }),
persist: true // 或更细粒度配置
}); - 插件会在 store 初始化时自动从 localStorage 读取并还原 state
- 退出时，Pinia 会自动清除持久化数据，同时你仍需手动
localStorage.removeItem('token')来广播变更
补充：防止“假同步”和边界情况
实际项目中容易忽略几个细节，导致同步失效或体验异常：
立即学习“前端免费学习笔记（深入）”；
- token 变更未写入 localStorage：比如只改了 Pinia 状态但忘了 setItem，其他 Tab 就收不到通知
- storage 事件监听时机太晚：必须在组件挂载后立即绑定，不能等路由就绪或异步逻辑之后
- 多域名或子域场景：localStorage 不共享，此时需换用 postMessage + iframe 中转，或统一走后端 session 管理
-
退出时未清空缓存视图：如果用了 KeepAlive，已登录态的页面组件可能仍保留旧用户数据，建议登出时手动清空
cachedViews并重置路由视图栈
这套方案不依赖 WebSocket 或服务端推送，轻量可靠，已在 Vue Vben Admin 等主流中后台框架中验证落地。
