Visual Studio Code

设置放在哪里

VS Code 的配置是一个 JSON 文件。命令行面板（Ctrl+Shift+P）里输入 Preferences: Open User Settings (JSON) 直接打开用户设置。

工作区设置会跟着 Git 一起提交，所以它天然是团队共享的——改之前先确认这个键该不该让全项目都吃到。

优先级：后面覆盖前面

这是最容易搞错的部分。后面的范围覆盖前面的：

1. 默认设置
2. 用户设置
3. 远程设置
4. 工作区设置
5. 工作区文件夹设置（多根工作区）
6. 语言特定的默认设置
7. 语言特定的用户设置
8. 语言特定的远程设置
9. 语言特定的工作区设置
10. 语言特定的工作区文件夹设置
11. 策略设置（管理员下发，永远最高）

最关键的一条：语言特定设置永远覆盖非语言特定设置，哪怕非语言特定设置的范围更窄。 也就是说，用户设置里的 "[python]" 块会压过工作区设置里的普通 "editor.tabSize"。写 "[python]": { "editor.formatOnSave": true } 时要意识到这一层。

语言块可以合并："[javascript][typescript]" 同时对两种语言生效。但合并时按完整语言串比较，"[typescript][javascript]" 的工作区设置盖不住 "[javascript]" 的用户设置——顺序不同就是不同的键。

值的合并方式也不一样

这一点很少有人注意，但它解释了「我明明改了却只生效一半」：

• 原始值和数组是整体覆盖。高优先级范围配了就用它的，低优先级的那个值直接作废。
• 对象类型是逐键合并。这正是 workbench.colorCustomizations 的行为：用户设置改了背景色，工作区设置改了前景色，最后两个都在，同名键才由工作区赢。

所以「换了主题颜色只变了一半」通常不是 bug，是合并语义本该如此。

排查设置不生效

设置没生效时按这个顺序查：

1. 搜索框加 @modified 过滤。它只列出值与默认值不同、或在对应 JSON 里被显式写过的设置项——你改过什么一目了然。
2. 检查是不是被语言块覆盖了（上面那条优先级）。
3. 确认写对了范围。用户设置和工作区设置分开放，同一个键写错地方不会有任何提示。

settings.json 里带注释和尾逗号是合法的（JSONC），但多一个逗号或少一个括号会导致整个文件写不进去，VS Code 只报一句 Unable to write settings. 加上几个红波浪线。实在乱了就把 {} 里清空，立刻回到默认值。

值要写对类型

设置项的取值是强类型的，写错类型不会生效：

json{
  "files.autoSave": "afterDelay",
  "editor.minimap.enabled": true,
  "files.autoSaveDelay": 1000,
  "editor.rulers": [80, 120],
  "search.exclude": { "**/node_modules": true }
}

"files.autoSave": "afterDelay" 是字符串，"editor.minimap.enabled": true 是布尔值。把布尔值写成字符串 "true" 是常见错误。settings.json 里有 IntelliSense，输入时会列出合法取值。