VS Code 用户设置和工作区设置怎样排查覆盖关系

VS Code 中，工作区设置通常覆盖同名的普通用户设置，但不能简单认为“Workspace 永远优先”。语言专属设置又有自己的覆盖层级，例如用户级 JavaScript 字号可能覆盖普通工作区字号。排查时要固定同一个窗口、同一个文件和同一个设置 ID，再逐层找出显式值。

下面以本地单文件夹中的 app.js 和 editor.fontSize 为例。假设普通 User 值为 14，普通 Workspace 值为 18，User 的 JavaScript 专属值为 20：在没有其他更高层覆盖的前提下，JavaScript 文件会采用 20。去掉错误的语言专属值后，才会回到工作区的 18。

官方设置文档：https://code.visualstudio.com/docs/configure/settings

数字是为说明覆盖关系设定的示例，不是本机运行结果。全部配图为原创界面说明图，不是 VS Code 截图；具体文字会随显示语言和版本略有区别，下文保留可搜索的英文命令与设置 ID。

1. 在 User 页记录同一设置的值

先打开出现问题的项目与目标文件。用命令面板搜索 Preferences: Open User Settings：Windows、Linux 通常按 Ctrl+Shift+P，macOS 按 Shift+Command+P。在设置搜索框输入 @id:editor.fontSize，确认当前选择的是 User 页，再记录 Editor: Font Size 的值。

这一层应确认“记录的是用户设置中的字号”，不是当前文件的最终有效值。字段显示 14，并不证明任何项目里都必须显示 14；仍要看有没有更高作用域的配置。若只想排查，不需要为了复现而更改自己的字号。

当前 Profile 也决定使用哪份用户设置。在同一窗口内完成后续比较，避免换了配置档案又拿两份不同的 User 值作对照。没有设置 UI 的视图时，也可以从命令面板打开相应 User Settings JSON，但不要直接覆盖整个文件。

2. 切到 Workspace 页寻找项目覆盖

保留 @id:editor.fontSize 搜索条件，点击设置顶部的 Workspace 页。若这个项目显式配置了字号 18，就把它与刚才的 User 值 14 分别记录。对于练习项目，可只在这个字段设置 18；实际排查则读取现有值，不随意改团队配置。

这一层的完成标志，是确认 Workspace 是否有自己的显式值，而不只是看到输入框里的数字。需要确认存储内容时，搜索命令 Preferences: Open Workspace Settings (JSON)，查看是否存在 editor.fontSize 条目。单文件夹项目一般存放在项目根目录的 .vscode/settings.json。

若目标文件不是这份项目中的文件，应重新确认窗口与文件位置。只有属于对应工作区的设置才能解释该文件的表现。对于同一个数字型设置，普通 Workspace 值会覆盖普通 User 值；此时仍不用删除 User 值，因为离开该项目时它可能继续作为个人偏好。

3. 加语言过滤检查专属设置

点击原来的 app.js，先看状态栏语言模式是否为 JavaScript。回到设置页，选 User，将搜索改为 @lang:javascript @id:editor.fontSize，查看语言专属的 Editor: Font Size。示例中这一项显式值为 20。

确认这一项确实被设置过，而不是仅显示继承值；可以加入 @modified 过滤，或打开 User Settings JSON 查看 JavaScript 配置块。下面是示例的用户设置对象，普通字号与语言字号分属不同字段位置：

{
  "editor.fontSize": 14,
  "[javascript]": {
    "editor.fontSize": 20
  }
}

这里顶层 editor.fontSize 是普通用户字号，[javascript] 内的是 JavaScript 专属字号。JSON 本身不插入注释；示例仅说明这两个位置，不要求把已有 settings 文件整份替换。

官方优先级将语言专属层列在非语言专属层之后，所以这份 User 语言字号可以覆盖普通 Workspace 的 18。接着保留相同语言过滤并切到 Workspace，确认那里没有另一份 JavaScript 专属字号；若有，继续记录它，不能在还没查看时断言 20 就是最终值。

这里只讨论单独的 [javascript] 配置。组合语言块并不等同于拆开的单语言块，存在它们时应按完整配置块检查，而不是把所有“含 javascript”的块视为相同作用域。

4. 重置错误覆盖并回到原文件确认

如果确认错误的是 User 页中的 JavaScript 专属字号，保留 @lang:javascript @id:editor.fontSize，在该设置旁的齿轮菜单选择 Reset Setting。不要在普通 User 或 Workspace 页误点，也不要删除整个 settings 文件；这是移除当前作用域中这个设置的显式覆盖，不是重置所有层。

然后打开 User Settings JSON，确认 [javascript] 里的这一条字号已不再显式配置；其他语言设置应保留。若通过 JSON 手工移除该条，保存文件后再继续。图形设置修改通常直接应用，不需要寻找额外的“保存配置”按钮。

在示例前提下，Workspace 页仍保存 18，User 普通值仍为 14，app.js 的编辑文本应按项目字号 18 显示。若仍不同，不要连续修改所有层：确认有没有 Workspace 语言设置、远程设置、文件夹设置或管理员策略。还要避免改变窗口缩放后仅凭视觉判断字号。

可以把设置 ID、原值、作用域和最终取舍记入项目说明：个人偏好放 User，确实要团队共享的值留在 Workspace。只有明确要分享的配置才纳入版本管理，不能把个人凭据或私人路径随手提交进去。

多根和远程项目还需注意什么

多根工作区的全局 Workspace 配置保存在 .code-workspace 中，各根文件夹还可能有自己的 .vscode/settings.json。设置 UI 会提供对应工作区和文件夹入口；排查目标文件时，需要选择它所在的文件夹，而不是随便打开另一个根目录的配置。官方说明：https://code.visualstudio.com/docs/editing/workspaces/multi-root-workspaces。

远程窗口还要考虑 Remote 层；受策略管理的设置可能被管理员值覆盖。另外，并非所有设置都支持 Workspace 范围。本例选用编辑器字号，不意味着更新、安全或整个应用级选项也能照同样方式覆盖。

常见问题

改 User 值却没变化，是否需要重装？先排查当前项目与语言的覆盖项，不应直接把作用域问题当作安装故障。

Reset Setting 会清掉所有层的配置吗？不是。应明确在哪个作用域与语言上下文重置单项，其他层仍可能决定结果。

为什么只在 JavaScript 文件中不同？查看语言模式与对应专属设置，同一个项目里的其他语言文件不一定使用这份覆盖。

最终要确认的不是“某个输入框变了”，而是原文件由预期作用域控制。记录各层，只修正错误覆盖项，才能保留仍然有用的个人和项目偏好。