settings.json是vscode最终生效的配置源，所有gui设置均转为此json键值对；其加载顺序为默认值→用户级→工作区级→文件夹级→插件默认值，同名项直接覆盖而非合并，且语言特设、插件集成等配置必须手动写入方括号语法或严格键名才生效。
settings.json 是 VSCode 读取并应用编辑器行为的最终配置源，不是“高级选项入口”，而是所有 GUI 设置背后实际生效的 JSON 表达——你点勾选、拖滑块、输数值，VSCode 最终都会转成 settings.json 里的键值对。它不替代图形界面，但能做图形界面做不到的事：批量覆盖、条件化启用、跨平台适配、插件深度绑定。
为什么改了 GUI 设置没生效？因为 settings.json 里有更高优先级的同名项
VSCode 的设置加载顺序是：默认值 → 用户级 settings.json → 工作区级 .vscode/settings.json → 文件夹级（多根工作区）→ 插件贡献的默认值。只要某一层写了 "editor.formatOnSave": false，哪怕你在 GUI 里把它打开，实际行为仍是关闭的。
- 检查当前生效的是哪一层：打开命令面板（
Ctrl+Shift+P或Cmd+Shift+P），输入Preferences: Open Settings (JSON)，看顶部注释是否含Workspace或User - 工作区配置文件路径必须是项目根目录下的
.vscode/settings.json，少一个点或放错位置都不加载 - 同名配置项不会合并，而是直接覆盖；比如用户级设了
"editor.tabSize": 4，工作区又写"editor.tabSize": 2，那打开这个项目时就是 2
哪些配置必须手动写进 settings.json，不能只靠 GUI？
GUI 界面会隐藏大量底层或条件化配置项，尤其涉及语言特异性、插件集成、跨平台兼容时，settings.json 是唯一途径。
- 语言专属设置必须用方括号语法：
"[javascript]"、"[python]"，GUI 里找不到入口，且必须是严格匹配的标识符（不能写"js"或"py"） - 插件专属配置如
"prettier.requireConfig"、"emeraldwalk.runonsave"，GUI 不提供开关，不写进 JSON 就等于没启用 - 跨平台换行符统一要用
"files.eol": "\n"（强制 LF），Windows 用户若只在 GUI 里调，Git 仍可能提交 CRLF - 需要注释说明的配置（比如团队规范依据），GUI 不支持注释，而 VSCode 允许在
settings.json中使用//或/* */
改完 settings.json 启动报错或设置失效？先查这三处
JSON 语法错误是静默失败的主因——VSCode 不会弹窗报错，只会跳过整个文件，回退到默认设置。
- 确认所有键名和字符串值都用双引号包裹：
"editor.fontSize"✅，editor.fontSize❌ - 删掉最后一行键值对后的逗号：
"files.autoSave": "afterDelay",❌（末尾逗号非法） - 避免单引号、尾随空格、不可见 Unicode 字符；用 VSCode 自带的 JSON 验证（红波浪线）比肉眼更可靠
- 如果怀疑是某条新增配置导致异常，可临时重命名
settings.json为settings.json.bak，重启 VSCode 看是否恢复，再逐条还原排查
真正容易被忽略的，是工作区配置的“作用域隐形性”：它只在你以文件夹形式打开项目时才加载；如果只是拖一个 .js 文件进 VSCode，.vscode/settings.json 完全不生效。这点在调试 CI 环境或共享配置时，常导致“本地正常、别人复现不了”的问题。
