工作区设置完全覆盖用户设置是VSCode配置生效的唯一规则，.vscode/settings.json中配置会彻底屏蔽同名用户设置，需按跨项目通用性决定配置存放位置，并确保工作区配置提交以保障协作一致。
工作区设置覆盖用户设置是唯一需要记住的规则
VSCode 的配置生效逻辑非常简单：只要 .vscode/settings.json 里写了某项，比如 "editor.tabSize"，它就直接生效，settings.json（用户级）里同名项完全不参与计算。这不是“优先级高一点”，而是“彻底屏蔽”。很多“配置不生效”问题，根源就是没意识到这点。
常见错误现象：
– 在用户设置里开了 "editor.formatOnSave": true，但保存时没格式化
– 团队成员缩进不一致，有人用 2 空格、有人用 4 空格
– 调试时断点不触发，却反复检查 launch.json，其实问题出在 debug.node.auto 被工作区设置关掉了
- 打开项目后，按
Ctrl + ,（Win/Linux）或Cmd + ,（Mac），左下角切换到「Workspace」标签再编辑，比手动找路径更稳 - 鼠标悬停在任意设置项上，弹出提示里会明确写「来自工作区设置」还是「来自用户设置」，这是最直接的验证方式
- 想快速定位是否被覆盖？在设置页顶部搜索框输入
@modified，所有被你改过的配置都会列出来，一眼就能看出哪些是工作区改的、哪些是用户改的
哪些该放用户设置，哪些必须进 .vscode/settings.json
判断标准只有一个：这个配置会不会被不同项目的技术栈干扰。不是凭经验，而是看它是否「跨项目通用」。
适合放用户设置（全局统一）：
-
editor.fontSize、workbench.colorTheme这类纯视觉/操作习惯项 -
files.trimTrailingWhitespace、editor.insertSpaces（如果你所有项目都用空格缩进） - 快捷键映射、终端默认 Shell 等个人工作流偏好
必须放工作区设置（项目绑定）：
-
python.defaultInterpreterPath：每个 Python 项目可能用不同虚拟环境 -
prettier.printWidth：前端项目要 80，后端项目可能要 120 -
eslint.enable或editor.defaultFormatter：团队约定用 Prettier 就得锁死 ID，比如"esbenp.prettier-vscode" - 语言块配置如
"[typescript]"：TypeScript 项目需单独启用格式化，而 JS 项目不用
工作区设置不提交 = 协作失效
.vscode/settings.json 是项目的一部分，不是个人临时文件。它不进 Git，协作就等于没配。
常见错误现象：
– 新成员 clone 项目后，保存不自动格式化，editor.formatOnSave 显示为 false
– CI 流水线报 ESLint 错误，但本地开发没报 —— 因为本地用户设置开了 ESLint，而 CI 只读工作区配置
- 确保
.vscode/settings.json在项目根目录，且已git add .vscode/settings.json - 不要把
editor.formatOnSave放用户层再指望团队遵守；它必须出现在工作区配置里，并和editor.defaultFormatter搭配使用 - 扩展配置（如 ESLint、Prettier）的行为依赖工作区设置，用户设置里的
eslint.validate或prettier.requireConfig在项目里大概率无效
远程开发时多了一层「远程用户设置」
通过 SSH 连 Linux 服务器开发时，VSCode 实际有三套设置：本地用户、远程用户、当前工作区。其中「远程用户设置」存于服务器上的 /home/xxx/.vscode-server/data/Machine/settings.json，它只影响你在那台机器上打开的所有远程工作区。
容易踩的坑：
- 在 Windows 上改了用户设置，以为远程开发也会同步 —— 不会，远程用户设置是独立的
- 远程工作区里调试失败，查了半天
launch.json，其实是远程用户设置了debug.javascript.terminalByDefault为 false，而本地没这行 - 远程项目用了 Node.js 18，但远程用户设置里指定了
node.debug.npmScript对应旧版本，导致脚本启动失败
验证方法：在远程窗口里按 Cmd + Shift + P（Mac）或 Ctrl + Shift + P（Win/Linux），运行 Preferences: Open Settings (JSON)，注意看打开的是哪个路径 —— 如果路径含 vscode-server，那就是远程用户设置。
真正起作用的永远是三层叠加后的结果：默认值 → 远程用户设置 → 当前工作区设置。别漏掉中间那一层。
