必须编辑用户级settings.json才能改全局设置：按Ctrl+,(Win/Linux)或Cmd+,(macOS)→点右上角{}图标→确认左下角显示“用户”；手动拼路径易错，工作区配置会静默覆盖用户级设置。
改全局设置，必须编辑用户级 settings.json，其他地方改了都不算数——工作区级（.vscode/settings.json）只影响当前项目，命令面板里点开的“设置”界面若显示“工作区”，你正在动的就不是全局。
怎么打开真正的用户级 settings.json
按 Ctrl + ,（Windows/Linux）或 Cmd + ,（macOS）→ 点右上角花括号 {} 图标 → 左下角状态栏显示“用户”才算对。空的 {} 表示还没配过，直接往里加键值对就行。
- 别手动拼路径：Windows 在
%APPDATA%\Code\User\，macOS 在~/Library/Application Support/Code/User/，容易错 - 别在已打开文件夹时误点：状态栏显示“文件夹”或“工作区”，说明你正编辑项目配置
- 改完不用重启 VSCode，但某些项（如
workbench.sideBar.location）需执行Developer: Reload Window
哪些配置能写进用户级 settings.json
只放不依赖具体项目的通用项，否则会失效或报错：
- ✅ 安全项：
editor.fontSize、editor.tabSize、files.autoSave、workbench.colorTheme、files.exclude - ✅ 语言默认块：
"[javascript]"、"[typescript]"必须放在顶层，不能嵌套在"editor.languageSettings"之类不存在的字段下 - ⚠️ 危险项：
python.defaultInterpreterPath、java.home（虽支持用户级，但路径写错会导致 Java 扩展无法启动）、emeraldwalk.runonsave（命令路径常随项目变） - ❌ 无效项：
java.format.onType、java.suggest.autoImports——查文档或搜索设置 UI，右侧没文件夹图标?的，一律不支持用户级
为什么改了不生效？最常被忽略的三件事
不是语法错，而是优先级和覆盖逻辑被忽视：
- 工作区配置静默覆盖：打开项目根目录，检查是否存在
.vscode/settings.json；里面有"workbench.sideBar.location": "left"，哪怕用户级写了"right"，它也会赢 -
editor.detectIndentation默认为true，它会在你打开每个文件时强行重设缩进，导致editor.tabSize看似没用——建议统一设为false - JSON 格式硬伤：结尾多逗号、用单引号、字符串没双引号，VSCode 底部会标红，鼠标悬停提示哪行错，但很多人直接忽略
别用全局替换改 settings.json
VSCode 的全局替换（Ctrl+Shift+H）是纯文本匹配，不认 JSON 结构：
- 会误改注释里的
"name"、字符串子串如"filename"、换行不一致的键值对 - 真要批量改，限定文件为
settings.json，启用正则，查找"editor\.fontSize"\s*:\s*\d+，替换前务必勾选Review changes - 改完立刻校验：粘贴到 JSONLint 或触发 VSCode 内置
jsonc.validate
真正难的不是写多少配置，而是分清哪些必须绑定项目、哪些能放全局——比如 java.configuration.runtimes 可以用户级声明多个 JDK，但 java.configuration.updateBuildConfiguration 必须放工作区，否则扩展根本读不到。
