直接调用 store.$reset() 可恢复 state 初始状态，但需满足 state 为返回新对象的函数且 Pinia ≥ 2.0.19；错误写法如复用外部对象会导致响应式失效，正确应使用箭头函数返回字面量对象，并在 TypeScript 中显式标注类型。
直接调用 store.$reset() 就能将 State 恢复为初始状态，但必须满足两个关键前提：state 必须是返回新对象的函数，且 Pinia 版本 ≥ 2.0.19（新版默认支持）。
确保 state 定义方式正确
Pinia 的 $reset() 依赖每次调用 state() 都生成一个全新对象。若复用外部对象或使用非函数形式，会导致响应式失效或数据污染。
- ✅ 正确写法：用箭头函数直接返回对象字面量
state: () => ({ count: 0, user: null, list: [] }) - ❌ 错误写法：引用外部变量或普通函数返回同一对象
const initState = { count: 0 }; state: () => initState - ? TypeScript 下建议显式标注返回类型，避免类型推断错误，例如：
state: (): { count: number; user: User | null } => ({ count: 0, user: null })
在组件中安全调用 $reset()
调用后 state 立即更新，但视图是否同步取决于你如何使用 store 数据。
- 模板中直接访问
{{ store.count }}或:count="store.count"→ 自动响应更新 - 已解构使用（如
const { count } = store）→ 解构变量不会更新，应改用toRefs(store)或保持对 store 的引用 - 子组件通过 props 接收时，只要 prop 是响应式绑定（如
:user="store.user"），$reset 后也能正常更新
配合业务逻辑完整清理
重置 state 只是第一步，真实场景中还需同步处理副作用和持久化数据。
- 先清除敏感字段：token、用户信息、菜单、路由等
- 再调用对应 store 的 $reset()，例如：
userStore.$reset()、cartStore.$reset() - 同步清理 localStorage / sessionStorage 中的缓存项
- 手动取消未完成请求、清除定时器、重置 router（如
resetRoutes()）
不满足自动 reset 条件时的备选方案
若因历史原因无法修改 state 定义（如 setup 形式 store 或旧版 Pinia），可手动还原：
- 用
Object.assign(store.$state, store.$options.state())替代 $reset - 或在 main.ts 中全局 patch $reset 行为（需 JSON 序列化初始态，注意 Date、Map 等不可序列化类型）
- 更稳妥的做法是重构 state 为函数形式，这是官方推荐且长期可维护的方式
