workspaceState 不保存的主因是未在插件激活后 await 调用 update()，且需确保存值为 JSON-safe 类型；其作用域为“插件+工作区路径”，跨工作区隔离，误用 globalState 或序列化失败亦会导致异常。
调试时 workspaceState 不保存？检查插件激活时机和上下文生命周期
VSCode 插件中 workspaceState 只在当前工作区（即打开的文件夹或 .code-workspace）内有效，且**必须在插件被正确激活后才能写入**。常见错误是：在 activate 函数外直接调用 context.workspaceState.update()，或在命令回调里未 await 写入操作，导致状态看似“丢失”。
实际行为是：如果插件尚未激活（比如用户还没触发任何命令），context.workspaceState 虽然存在，但写入可能被静默忽略；更隐蔽的是，若插件被禁用后重启用，旧 workspaceState 仍存在，但新写入若没 await 就返回，Promise 会被丢弃。
- 确保所有
update()调用都包裹在async函数中，并await context.workspaceState.update(key, value) - 不要在
deactivate里清理workspaceState—— 它本就该跨会话保留；真要清，用context.workspaceState.update(key, undefined) - 验证是否生效：在调试控制台执行
context.workspaceState.get('yourKey')，而非只看代码逻辑
为什么换工作区后 workspaceState 还在？这是设计，不是 bug
workspaceState 的作用域是“插件 + 当前工作区路径”，不是“当前窗口”。也就是说，如果你在 /project-a 中存了 buildStatus: 'success'，然后关闭 VSCode、再打开 /project-b，前者的状态不会污染后者——因为路径不同，底层存储 key 是哈希过的完整路径 + 插件 ID。
但容易混淆的点在于：如果你用的是单文件夹工作区（即直接打开一个文件夹），又反复用“文件 → 打开文件夹”切换，VSCode 实际上会复用同一个工作区上下文（尤其在快速重启时），导致 workspaceState 看似“残留”。
- 真正隔离的标志是：资源管理器顶部显示
[Workspace]且左侧列出多个根目录，或你明确打开了xxx.code-workspace文件 - 想彻底清空某个工作区的
workspaceState？删掉~/.vscode/extensions/your-ext-id/storage.json对应路径段（不推荐手动删，应通过插件逻辑清理） - 调试时建议在
activate里打日志：console.log('WS path:', context.storagePath)，确认路径是否符合预期
调试中 globalState 和 workspaceState 混用导致状态错乱
典型误用场景：把用户级开关（如“是否启用预览功能”）存在 workspaceState，结果换项目后要重新设置；或把构建输出路径这种工作区专属数据存在 globalState，导致所有项目共享同一路径出错。
根本区别在于生命周期和可见范围：globalState 是插件维度，所有工作区共用一份；workspaceState 是工作区维度，哪怕同一台机器开 10 个不同文件夹，也有 10 份独立副本。
- 存用户偏好（如主题选择、快捷键开关）→ 用
context.globalState - 存项目相关状态（如上次编译时间、临时 token、折叠节点列表）→ 用
context.workspaceState - 两者值都必须是 JSON-safe：不能含
undefined、Date、Map；new Date().toISOString()可以，new Date()不行
保存失败却没报错？检查磁盘权限和序列化边界
workspaceState.update() 返回 Promise，但 VSCode 不抛出磁盘满、权限拒绝等底层错误——它只是静默失败。你看到“没保存”，大概率是 Promise 被 reject 但没 catch。
另一个高频坑是：试图存一个带循环引用的对象，或含 function / RegExp 的配置项，JSON 序列化时直接丢掉字段，读出来就是 undefined。
- 务必对每个
update()做try/catch或.catch(err => console.error('WS save failed:', err)) - 写入前先
console.log(JSON.stringify(value, null, 2))，确认能完整序列化 - 避免存大对象：超过 1MB 可能触发 VSCode 存储限制，状态文件会变臃肿甚至损坏
workspaceState，实际测试环境是单文件夹打开，而你本地开发用的是 .code-workspace —— 两者的 context.storagePath 根本不同，状态天然隔离。别靠猜，先打日志看路径。 
