插件必须通过vscode.workspace.getConfiguration()读取settings.json配置，不可直接读文件；监听用onDidChangeConfiguration并配合affectsConfiguration守卫；多根工作区需遍历folder调用getConfiguration(section, folder.uri)；inspect()中字段undefined表示未显式设置，非缺失。
如何在插件中读取当前工作区的 settings.json 配置项
插件不能直接读取 .vscode/settings.json 文件内容，必须通过 VSCode 提供的配置 API 获取解析后的值。调用 vscode.workspace.getConfiguration() 是唯一安全、跨平台、支持多根工作区的方式。
关键点：
-
getConfiguration(section?, resource?)的section是配置项前缀（如"editor"、"files.autoSave"），不是文件路径 - 若未传
resource，默认读取「活动编辑器」对应文档所在工作区的配置；多根工作区下，它自动匹配最贴合的文件夹 - 读取嵌套配置（如
editor.tabSize）时，section写"editor"，再用.get("tabSize")，不要写完整字符串键名 - 返回值是
WorkspaceConfiguration对象，支持.get()、.has()、.inspect()，但不支持点链式访问（config.editor.tabSize会报错）
监听配置变更：onDidChangeConfiguration 不会触发的 3 种情况
vscode.workspace.onDidChangeConfiguration 是监听配置变化的唯一标准事件，但它有明确的触发边界——不是所有“看起来像配置改了”的场景都会触发。
常见不触发情形：
- 用户修改了
settings.json但没保存（仅编辑未写入磁盘） - 配置被其他插件或 CLI 覆盖写入（如 Prettier 插件自动重写
editor.formatOnSave），但未通过 VSCode 配置 API 更新，事件不会广播 - 修改的是用户级设置（
~/.vscode/settings.json）而当前工作区有同名覆盖项——此时只触发工作区级变更通知，用户级变动静默忽略
正确监听姿势：始终用 event.affectsConfiguration("your.section.name") 做守卫判断，不要依赖 event 的原始值做业务逻辑分支。
多根工作区下配置读取的优先级与陷阱
当打开一个 .code-workspace 文件，且其中多个文件夹都定义了同名配置（比如都设了 "editor.insertSpaces": false），VSCode 会按固定顺序合并：文件夹级 > 工作区级（.code-workspace 中的 settings） > 用户级。
插件开发中容易踩的坑：
- 调用
getConfiguration("editor")时，返回的是**合并后生效值**，无法直接区分来源；需用.inspect("insertSpaces")查看workspaceFolderValue、workspaceValue、userValue字段 - 如果插件需要为每个文件夹单独初始化行为（例如为每个前端项目启动独立 LSP），不能只监听一次配置变更——必须遍历
vscode.workspace.workspaceFolders，对每个文件夹调用getConfiguration(section, folder.uri) -
.code-workspace中的settings是全局作用于整个工作区的，但插件无法通过 API 区分它是来自该文件还是某个子文件夹的.vscode/settings.json；只能靠inspect()的字段非空判断
为什么 config.inspect() 返回的某些字段是 undefined
.inspect(key) 返回对象里 workspaceFolderValue、workspaceValue、userValue 等字段为 undefined，不代表配置缺失，而是表示该层级**未显式设置**该值——它可能来自更上层继承，或使用了 VSCode 默认值。
例如：
- 项目没配
files.autoSave，workspaceFolderValue和workspaceValue都是undefined，但defaultValue是"off" - 用户在全局设置了
editor.tabSize: 4，但项目中没覆盖，则userValue === 4，其余为undefined - 只有当某一层级真正写入了该配置（哪怕写成和默认值一样），对应字段才会有值
所以插件里做配置决策时，别只检查是否 !== undefined，要结合 defaultValue 和实际生效值（.get(key)）综合判断。这点在实现“用户可选是否启用某功能”时尤其关键——开关关了，可能是用户主动关的，也可能是压根没配过。
