VSCode中ConfigurationChangeEvent如何区分用户/工作区配置变更？

ConfigurationChangeEvent本身没有直接提供配置来源的属性，但可以通过以下方法判断变更是来自全局（用户）配置还是工作区配置：

方法：利用event.changes中的层级值对比 #

每个变更的配置项在event.changes中会包含对应不同配置层级的属性：

• userValue：全局（用户）配置的当前值
• workspaceValue：工作区配置的当前值
• workspaceFolderValue：工作区文件夹配置的当前值（多工作区场景）

通过对比这些值与对应层级的配置快照，就能确定变更来源。

代码示例 #

import * as vscode from 'vscode';

vscode.workspace.onDidChangeConfiguration((event) => {
  // 获取所有变更的配置键（若未指定特定键，affectsConfiguration('')会返回true，此时遍历所有变更）
  const changedKeys = event.affectsConfiguration('') ? Array.from(event.changes.keys()) : [];

  for (const key of changedKeys) {
    const change = event.changes.get(key);
    if (!change) continue;

    // 获取各层级的当前配置值
    const currentUserValue = vscode.workspace.getConfiguration().get(key, undefined, vscode.ConfigurationTarget.Global);
    const currentWorkspaceValue = vscode.workspace.getConfiguration().get(key, undefined, vscode.ConfigurationTarget.Workspace);

    // 判断变更来源
    if (change.userValue !== currentUserValue) {
      console.log(`配置项 "${key}" 来自全局（用户）配置变更`);
    } else if (change.workspaceValue !== currentWorkspaceValue) {
      console.log(`配置项 "${key}" 来自工作区配置变更`);
    } 
    // 多工作区文件夹场景可额外判断workspaceFolderValue
    else if (vscode.workspace.workspaceFolders) {
      const currentFolderValue = vscode.workspace.getConfiguration().get(key, undefined, vscode.ConfigurationTarget.WorkspaceFolder);
      if (change.workspaceFolderValue !== currentFolderValue) {
        console.log(`配置项 "${key}" 来自工作区文件夹配置变更`);
      }
    }
  }
});

注意事项 #

1. 部分配置可能同时在多个层级存在设置，需要根据实际业务场景判断优先级或具体变更层级
2. 若只需监听特定配置项的变更，可在affectsConfiguration中传入具体键名（如event.affectsConfiguration('editor.fontSize')），避免遍历所有变更

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