多根工作区中 workspaceState 为 undefined 是设计使然，仅单根模式下存在；应改用 globalState + 路径构造键名，命令处理需在 handler 内校验 workspaceFolders，配置读取须指定 URI 作用域。
插件在多根工作区中无法读取 workspaceState，不是 bug，是设计使然——它压根就不存在。
workspaceState 在 multi-root 下为什么总是 undefined
VS Code 明确不为多根工作区提供统一的 workspaceState。这个对象只在单根（single-root）模式下由编辑器自动初始化；一旦启用 multi-root，extensionContext.workspaceState 就保持未定义状态，任何直接调用 get() 或 update() 都会静默失败或抛出 TypeError。
常见错误现象包括：插件激活后状态丢失、右键菜单项消失、上次打开的面板不恢复、自定义视图数据清空。
- 不要在
activate()里同步读取extensionContext.workspaceState.get('xxx')—— 它此时一定是undefined - 检查
vscode.workspace.workspaceFolders是否存在且长度 > 0，再决定是否走 workspaceState 分支 - 若必须按工作区隔离状态，手动构造键名存入
globalState，例如：`state_${folder.uri.fsPath.replace(/[/\]/g, '_')}_lastActiveTab` - 避免用
vscode.workspace.rootPath（已废弃），改用vscode.workspace.workspaceFolders[0]?.uri.fsPath并加空值判断
registerCommand 在多根中注册成功但不响应
命令注册本身不会报错，但 handler 里一碰路径或文件夹就卡住，本质是执行时上下文缺失：命令触发时 workspaceFolders 可能为空，或活动编辑器不在任一已注册的根目录下。
典型表现：插件控制台无 log，右键菜单显示但点击无反应，快捷键失效。
- 注册命令时别依赖
vscode.workspace.workspaceFolders[0]做预处理，全部逻辑移到 handler 内部 - 在 handler 开头加防御判断：
if (!vscode.workspace.workspaceFolders || vscode.workspace.workspaceFolders.length === 0) return; - 要获取当前编辑器所属文件夹，优先用：
vscode.window.activeTextEditor?.document.uri→vscode.workspace.getWorkspaceFolder(uri) - 调试时打开 Output 面板，选择你的插件通道，确认 handler 是否被调用；再打印
vscode.workspace.workspaceFolders看是否为空数组
配置读取 getConfiguration 不生效的根源
插件调用 vscode.workspace.getConfiguration('myext') 默认读的是用户级配置，完全忽略 .code-workspace 中的 settings 块和各子文件夹下的 .vscode/settings.json。
这导致你在工作区里配了 "myext.autoSave": true，插件却始终读到 false。
- 必须显式指定作用域：用
vscode.workspace.getConfiguration('myext', vscode.window.activeTextEditor?.document.uri) - 如果配置影响全局行为（比如是否启用某功能），建议 fallback 到
globalState+ 用户设置监听：vscode.workspace.onDidChangeConfiguration - 不要假设
activeTextEditor存在——命令可能从资源管理器右键触发，此时需用vscode.window.activeTextEditor或vscode.workspace.workspaceFolders[0]降级兜底 - 注意大小写敏感：
getConfiguration('MyExt')和package.json里声明的contributes.configuration.title必须一致
多根适配最易被忽略的点：所有对 workspaceState、workspaceFolders、getConfiguration 的访问，都必须是「按需、异步、带兜底」的。没有初始化时机，只有响应时机；没有默认上下文，只有当前上下文。
