工作区设置（.vscode/settings.json）覆盖同名用户设置，是核心规则；快捷键Ctrl+,（Win/Linux）或Cmd+,（Mac）打开设置页，右上角点“打开设置(JSON)”可直接编辑对应作用域配置。
工作区设置（.vscode/settings.json）会覆盖同名的用户设置（settings.json），这是唯一需要记住的核心规则；其余都是围绕它展开的具体应用。
怎么快速打开并编辑 User Settings 和 Workspace Settings
不用手动找路径——VSCode 提供了直接入口：
- 按
Ctrl + ,（Windows/Linux）或Cmd + ,（macOS）打开图形化设置页，右上角点击「打开设置（JSON）」图标即可编辑当前作用域的settings.json - 在设置页顶部搜索框输入
@modified，能立刻看到所有被你改过的配置项，方便核对是否误改了全局设置 - 如果已打开某个项目文件夹，设置页左下角会显示「User（全局）」和「Workspace（当前工作区）」两个标签，点切换就能分别编辑
- 想确认当前生效的是哪个值？把鼠标悬停在某项设置上，弹出的提示里会写明「来自用户设置」或「来自工作区设置」
哪些配置该放 User Settings，哪些必须放 Workspace Settings
判断标准只有一个：这个配置是否「跨项目通用」。不是靠感觉，而是看它是否会被不同技术栈干扰：
-
editor.fontSize、workbench.colorTheme、editor.fontFamily—— 这些纯个人视觉/操作习惯，放在 User Settings 里，一劳永逸 -
editor.tabSize、editor.insertSpaces、files.trimTrailingWhitespace—— 看项目规范，Python 项目要 4 空格、TypeScript 项目要 2 空格，这类必须进.vscode/settings.json，否则协作时格式错乱 -
eslint.enable、prettier.printWidth、python.defaultInterpreterPath—— 工具链路径和规则强绑定项目，只应出现在 Workspace Settings，且建议提交到 Git - 语言专属设置（如
[javascript]块）可同时存在于两种配置中，但 Workspace Settings 中的同语言块仍会覆盖 User Settings 中的对应块
常见错误现象和排查方法
很多“配置不生效”问题，其实只是没看清作用域层级：
- 改了 User Settings 的
editor.tabSize，但打开项目后还是 2 空格 → 检查项目根目录是否存在.vscode/settings.json，里面很可能有"editor.tabSize": 2 - 团队成员格式化结果不一致 → 确认
.vscode/settings.json是否已提交，以及是否启用了统一的格式化扩展（如 Prettier），且其配置未被用户设置中的editor.formatOnSave关闭 - 调试时断点不触发、launch.json 报错 →
launch.json属于.vscode/下独立配置，和 settings.json 无关；但它的行为可能受debug.node.autoAttach这类设置影响，而该设置若在 Workspace 中设为false，就会屏蔽自动附加 - 修改后没反应 → VSCode 不会实时重载所有设置，部分配置（如主题、字体）需重启窗口，但大多数编辑器行为（缩进、保存）改完即生效
最容易被忽略的一点：VSCode 允许在同一个项目里混用 .vscode/settings.json 和 .code-workspace 文件，后者优先级更高。如果你用 File > Save Workspace As 创建过工作区文件，那它里面的设置会压过 .vscode/settings.json —— 很多人卡在这里半天找不到原因。
