多根工作区下Extension Host CPU飙高，需用Developer: Open Process Explorer定位含ms-python.python等的并发实例，检查命令行是否带多个--folder-uri；临时移除文件夹验证回落，并将files.watcherExclude配置到.code-workspace的settings块中，通配符必须为/xxx/，且需重开工作区生效。

多根工作区里 Extension Host CPU 飙高怎么定位

多根工作区（Multi-root Workspace）下，Extension Host 进程更容易失控——不是因为插件变重了，而是多个文件夹触发了重复监听、重复激活或状态争抢。直接看 code --status 会发现多个 Extension Host 子进程同时跑，CPU 合计常超 80%。

实操建议：

VSCode

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

下载

• 先运行 Developer: Open Process Explorer，重点筛名称含 ms-python.python、esbenp.prettier-vscode、dbaeumer.vscode-eslint 的条目；多根场景下，它们常为每个 workspaceFolder 单独启一个服务实例
• 右键高占用扩展 → Copy Process Info，粘贴后看命令行是否带多个 --folder-uri 参数——有就说明它正在跨文件夹并发解析
• 临时关闭部分文件夹：右键资源管理器中某个文件夹 → Remove Folder from Workspace，观察 CPU 是否阶梯式回落；比全禁插件更快锁定问题源

workspaceState 读不到值？别急着报错，先查上下文

extensionContext.workspaceState 在多根工作区中默认为 undefined，这不是 bug，是 VS Code 明确的设计行为。很多插件一启动就试图读取它，结果静默失败，后台却持续轮询或重试，拖慢响应。

实操建议：

• 不要在 activate() 里直接调用 context.workspaceState.get('key')；改用 vscode.workspace.onDidChangeWorkspaceFolders 监听事件，在回调中按需获取
• 若必须存状态，优先用 context.globalState；但注意它不区分工作区——比如你在前端文件夹设了 lastUsedBranch，后端文件夹也会读到同一值
• 真要按工作区隔离，手动构造键名：`state_${vscode.workspace.workspaceFolders[0]?.uri.fsPath.hashCode()}_${key}`，再存进 globalState；别用 replace(/[/\]/g, '_')，Windows 路径斜杠处理容易出错

命令注册成功但不响应？大概率卡在 workspaceFolders 为空

多根工作区刚打开时，vscode.workspace.workspaceFolders 可能还是空数组，尤其在远程开发（SSH/WSL）或大型 monorepo 中。插件若在激活时同步注册命令，并依赖 workspaceFolders[0] 构造路径，命令就会注册失败——控制台无报错，右键菜单也不出现。

实操建议：

• 注册命令时，**不要**写 vscode.workspace.workspaceFolders[0].uri；改用命令 handler 内部按需获取：vscode.window.activeTextEditor?.document.uri 反推所属文件夹
• 每个命令开头加防御判断：if (!vscode.workspace.workspaceFolders || vscode.workspace.workspaceFolders.length === 0) return;
• 调试时打开输出通道：Developer: Toggle Developer Tools → Console 标签页，确认是否进入 handler；再打印 vscode.workspace.workspaceFolders 看是不是空数组

files.watcherExclude 在多根工作区里为什么没生效

多根工作区下，files.watcherExclude 必须写在 .code-workspace 文件的 settings 块里，而不是用户级 settings.json。否则 VS Code 会为每个文件夹单独启用监听器，而你配的规则只作用于主工作区上下文。

实操建议：

• 在 .code-workspace 中明确配置：

  {
    "folders": [...],
    "settings": {
      "files.watcherExclude": {
        "**/node_modules/**": true,
        "**/dist/**": true,
        "**/.git/**": true,
        "**/build/**": true
      }
    }
  }

• 通配符必须是 **/xxx/**，写成 /node_modules/ 或 *node_modules* 全无效；且生效前提是关闭并重新打开整个工作区，仅保存文件不触发重载
• Linux/macOS 用户顺手检查：cat /proc/sys/fs/inotify/max_user_watches，若低于 524288，需执行 sudo sysctl fs.inotify.max_user_watches=524288，否则即使配对也撑不住多根监听压力

多根工作区的性能陷阱不在单个插件有多重，而在多个插件对同一套机制（如文件监听、语言服务、状态管理）各自“认领”一份副本——你看到的 CPU 高，常常是三四个 tsserver 实例在同时索引同一份 node_modules。