context.workspaceState.get 返回 undefined 的根本原因是数据未持久化到磁盘，因 workspaceState 依赖插件 deactivate 时调用 update 才异步落盘，若未实现 deactivate 或插件异常终止，则数据仅驻留内存。
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，自然为空。
-
globalState：跨工作区、跨 VSCode 实例生效，适合用户偏好、登录态、全局计数器等。路径固定，不受当前打开文件夹影响 -
workspaceState：绑定当前工作区（即 .vscode 文件夹所在目录），关闭该文件夹后状态自动清理。适合项目级缓存，比如上次编辑位置、临时构建标记 - 两者 API 完全一致（
get/update/setKeysForSync），但数据物理存放位置不同：globalState存在用户数据目录的globalStorage子目录，workspaceState存在工作区根目录下的.vscode/workspaceStorage
如何快速验证数据是否真被写入磁盘
别依赖 get 返回值做判断——它可能从内存缓存读，而非磁盘。直接看文件更可靠。
- Windows：检查
%USERPROFILE%\AppData\Roaming\Code\User\globalStorage\<publisher>.<extension>（globalState）或<workspace-root>\.vscode\workspaceStorage\<hash>\state.vscdb（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()）
插件重载时数据丢失的典型场景
开发中频繁按 Ctrl+Shift+P → “Developer: Reload Window”，看似方便，实则会清空 workspaceState——因为重载会销毁并重建整个工作区上下文，而 deactivate 不保证被调用。
- 调试阶段优先用
globalState，避免被重载干扰 - 若必须用
workspaceState，改用 “Developer: Restart Extension Host”（不重启窗口），它会保留工作区状态 - 在
activate里加日志：检查context.storagePath是否为空，为空说明当前没进入有效工作区上下文
真正难排查的从来不是语法错误，而是状态生命周期和作用域的错位——workspaceState 不是 localStorage，它不会自动同步到磁盘，也不会跨窗口共享。每次存之前，先想清楚：这个值，到底属于用户、属于项目、还是属于此刻的编辑会话？
