插件配置需显式声明并正确作用域设置，否则无法读取；必须监听 onDidChangeConfiguration 事件手动响应变更，否则界面不刷新。
插件首选项设置不是“装完就生效”，必须在 settings.json 中显式声明或通过命令触发读取，否则扩展根本收不到你配的值。
vscode.workspace.getConfiguration() 读不到自定义配置？
常见错误是只在 package.json 的 contributes.configuration.properties 里定义了 hello.title，但没在用户 settings.json 或工作区设置里真正写入该键值。VS Code 不会自动填充默认值到配置存储中 —— default 只在调用 .get("hello.title") 且该 key 完全未设置时才兜底生效。
- 检查是否已在 VS Code 设置 UI 中手动修改过该配置项（哪怕改回原值），否则它不会落地到 JSON 层
- 直接编辑
settings.json，手动加一行："hello.title": "选项一"，再重启或重载窗口 - 使用
vscode.workspace.getConfiguration().inspect("hello.title")查看workspaceValue和globalValue是否为空 —— 这是定位“为什么读不到”的最快方式
配置作用域（scope）选错导致行为异常
scope 决定配置生效范围，但很多人忽略它和实际读取逻辑的耦合关系。比如设为 "scope": "resource" 的配置，在非文件上下文（如空标签页、欢迎页）中根本不可读；而 "scope": "window" 的配置在多根工作区里可能被不同文件夹覆盖。
-
"scope": "application"：全局生效，无法被工作区覆盖（适合插件开关类配置） -
"scope": "machine"：仅当前机器有效，同步设置时会被跳过（慎用） - 若插件需响应文件类型变化（如对
.vue文件启用特殊背景），应设"scope": "resource"并监听onDidChangeConfiguration事件
动态更新配置后界面不刷新？
调用 vscode.workspace.getConfiguration().update() 只写入配置存储，不会自动触发插件重绘或重载逻辑。你得自己监听变更并响应 —— 这是插件开发中最容易漏掉的一环。
- 在
activate()中注册监听：vscode.workspace.onDidChangeConfiguration(e => { if (e.affectsConfiguration("hello.title")) { /* 重新应用背景/刷新UI */ } }) - 注意
update()的第三个参数：true表示写入workspace级，false（默认）写入user级；多根工作区下务必明确指定 - 如果配置影响编辑器背景（如
vscode-background），需主动调用其内部刷新方法（如refreshBackground()），不能依赖配置变更自动生效
配置项本身没有“热更新”能力，所有视觉或行为变化都依赖插件作者是否实现了监听与响应逻辑。别假设改完 settings.json 就万事大吉 —— 先看插件文档有没有提 onDidChangeConfiguration，再查源码里有没有对应处理。这是定制化深度和稳定性的分水岭。
