VSCode插件调试之持久化数据存储与读取异常定位-VSCode-PHP中文网

context.workspacestate.get 返回 undefined 的根本原因是数据未持久化到磁盘，因 workspacestate 依赖插件 deactivate 时调用 update 才异步落盘，若未实现 deactivate 或插件异常终止，则数据仅驻留内存。

vscode插件调试之持久化数据存储与读取异常定位

VSCode 插件中用 context.workspaceState.get 读不到上次存的值，不是代码写错了，大概率是没触发持久化时机或作用域错配。

为什么 `context.workspaceState.get` 总是返回 `undefined`

插件调用 context.workspaceState.update 后立即 get 能拿到值，但重启 VSCode 就没了——这是最典型的“以为存了，其实没落盘”现象。根本原因在于：workspaceState 的写入是异步且延迟 flush 的，它依赖插件被正常卸载（deactivation）才能完成持久化。如果你没实现 deactivate 钩子，或插件被强制终止（如崩溃、禁用、VSCode 强退），数据就永远卡在内存里。

必须在插件的 deactivate 函数中调用 context.workspaceState.update，不能只靠运行时中间更新
workspaceState 是工作区级存储，仅当打开的是文件夹（而非单个文件或空窗口）时才可用；用 context.globalState 替代可绕过此限制
存的值必须是 JSON 可序列化的类型（undefined、function、Date、RegExp 等都会被静默丢弃）

`context.globalState` 和 `context.workspaceState` 到底该用哪个

选错存储作用域是调试时最隐蔽的坑：你存到 globalState，却在另一个插件实例里查 workspaceState，自然为空。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

globalState：跨工作区、跨 VSCode 实例生效，适合用户偏好、登录态、全局计数器等。路径固定，不受当前打开文件夹影响
workspaceState：绑定当前工作区（即 .vscode 文件夹所在目录），关闭该文件夹后状态自动清理。适合项目级缓存，比如上次编辑位置、临时构建标记
两者 API 完全一致（get/update/setKeysForSync），但数据物理存放位置不同：globalState 存在用户数据目录的 globalStorage 子目录，workspaceState 存在工作区根目录下的 .vscode/workspaceStorage

如何快速验证数据是否真被写入磁盘

别依赖 get 返回值做判断——它可能从内存缓存读，而非磁盘。直接看文件更可靠。

Windows：检查 %USERPROFILE%\AppData\Roaming\Code\User\globalStorage\<publisher>.<extension></extension></publisher>（globalState）或 <workspace-root>\.vscode\workspaceStorage\<hash>\state.vscdb</hash></workspace-root>（workspaceState）
macOS/Linux：对应路径为 $HOME/Library/Application Support/Code/User/globalStorage/... 或 $PWD/.vscode/workspaceStorage/.../state.vscdb
state.vscdb 是 SQLite 文件，可用 sqlite3 state.vscdb 'SELECT * FROM ItemTable' 查原始键值对（注意 key 带有插件 ID 前缀）
如果文件存在但表为空，说明 update 根本没执行；如果表里有 key 但 value 是 null，说明存的是不可序列化值（如 new Date()）