如何在VSCode扩展中实现when子句上下文的跨重启持久化

问题本质 #

setContext 命令写入的所有自定义上下文值，都是 VSCode 当前运行会话维护的内存级临时键值对，本身不会做任何磁盘持久化：VSCode 进程退出后这部分内存数据就会被直接回收，重启后自然找不到之前设置的上下文键值。这也是你执行 Developer: Inspect Context Keys 命令时，找不到 myExt.activated 的核心原因——重启后的 VSCode 是全新的进程内存空间，之前会话写入的临时值根本没有被加载。

跨重启持久化的实现方法 #

要让自定义 when 上下文跨重启生效，必须结合 VSCode 扩展提供的持久化存储能力，分两步完成逻辑闭环：

1. 把需要持久化的状态值存在 VSCode 的持久化存储里
   替代直接用 setContext 存临时值的逻辑，把核心状态写入 context.globalState（全局持久化，跨工作区生效）或 context.workspaceState（仅对当前打开的工作区生效），这两个存储接口的数据会被VSCode写入本地磁盘，重启后不会丢失。
   比如修改你的 start 命令逻辑：

   let start = vscode.commands.registerCommand('myExt.start', () => {
       // 先把状态写入磁盘持久化存储
       context.globalState.update('myExt.activated', true);
       // 再把值同步到内存级when上下文，供VSCode的UI、菜单逻辑读取
       vscode.commands.executeCommand('setContext', 'myExt.activated', true);
   });
   

2. 扩展激活时主动把持久化值加载回内存上下文
   VSCode 启动时会加载激活的扩展，你需要在扩展的初始化入口（也就是 activate 函数里），主动从持久化存储读出之前存的状态值，重新写入内存级的 when 上下文，这样重启后上下文值才能和你上次会话的状态保持一致：

   export function activate(context: vscode.ExtensionContext) {
       // 从磁盘读取之前保存的激活状态，默认值设为false
       const savedActivatedState = context.globalState.get<boolean>('myExt.activated', false);
       // 把持久化的值同步回当前会话的when上下文
       vscode.commands.executeCommand('setContext', 'myExt.activated', savedActivatedState);
   
       // 此处放你原来的命令注册、其他扩展初始化逻辑
       let start = vscode.commands.registerCommand('myExt.start', () => {
           context.globalState.update('myExt.activated', true);
           vscode.commands.executeCommand('setContext', 'myExt.activated', true);
       });
   }
   

   完成上述两步逻辑后，你之前配置的、以myExt.activated为when条件的资源管理器菜单项，就会在VSCode重启后根据上次保存的状态正常显示，不需要额外修改菜单配置。

注意事项 #

• 不要尝试寻找能自动持久化 setContext 值的全局配置，这是VSCode的设计定位：setContext 从设计之初就是为会话内动态临时状态服务的（比如根据当前光标位置、打开文件类型实时变化的UI显隐逻辑），本身就不需要跨会话保留。
• 如果你的状态只需要对单个工作区生效，把 context.globalState 替换成 context.workspaceState 即可，两套接口的调用逻辑完全一致。
• 如果需要在用户修改插件配置时自动更新对应的 when 上下文，可以监听 VSCode 的配置变更事件，在配置值变化时重新执行 setContext 同步最新值，不需要依赖用户手动触发命令。

内容的提问来源于stack exchange，提问作者nrofis