确认修改的是工作区配置而非全局配置，需满足三个条件：以文件夹方式打开项目（状态栏显示“folder: xxx”）、.vscode/settings.json位于项目根目录、通过命令面板执行“preferences: open workspace settings (json)”且路径明确含“.vscode/settings.json”；若弹出无前缀的settings.json，则正在误改全局配置。
怎么确认你改的是工作区配置，不是全局配置
直接打开 settings.json 文件编辑，90% 的概率会误改全局设置。VSCode 设置编辑器默认展示用户级配置，点「Edit in settings.json」就写进 %APPDATA%\Code\User\settings.json（Windows）或 $HOME/Library/Application Support/Code/User/settings.json（macOS），所有项目都会受影响。
真正生效的工作区配置必须满足三个条件：以文件夹方式打开项目（状态栏显示 Folder: xxx）、.vscode/settings.json 存在且位于项目根目录、编辑时路径明确含 .vscode/。
- 用
Ctrl+Shift+P→ 输入Preferences: Open Workspace Settings (JSON)，弹出的文件路径里必须带.vscode/settings.json - 如果弹出的是
settings.json（无前缀），说明你在改全局，立刻停手 - 检查左下角状态栏——没有
Folder: xxx提示，.vscode配置压根不加载
哪些配置能被工作区覆盖，哪些根本无效
VSCode 对设置项做了硬性作用域限制，并非所有键都能写进 .vscode/settings.json 生效。比如 workbench.colorTheme 和 window.zoomLevel 是用户级锁定项，写进去也完全被忽略。
判断一个配置是否支持工作区级覆盖，最可靠方法是：在设置 UI 搜索该配置项，看右侧图标——出现文件夹图标（?）表示支持，只有齿轮图标（⚙️）则仅限全局。
- 可覆盖的典型项：
editor.tabSize、files.exclude、python.defaultInterpreterPath、eslint.validate - 不可覆盖的常见项：
workbench.colorTheme、update.mode、telemetry.enableTelemetry、extensions.ignoreRecommendations -
editor.tokenColorCustomizations可以工作区生效，但必须完整包裹在"editor.tokenColorCustomizations": { ... }结构内，漏掉外层键名即失效
Python 解释器路径等关键配置怎么写才真正隔离
像 python.defaultInterpreterPath 这类配置，目的是让项目绑定自己的虚拟环境，但如果写成绝对路径（如 /home/user/project/venv/bin/python），换机器或换用户就直接崩。它必须用相对路径或变量，否则“隔离”只是假象。
- 推荐写法：
"python.defaultInterpreterPath": "./venv/bin/python"（Linux/macOS）或"./venv/Scripts/python.exe"（Windows） - 也可用变量：
"${workspaceFolder}/.venv/bin/python"，但注意${workspaceFolder}在某些旧版 Python 扩展中解析不稳定 -
files.exclude和search.exclude中的路径基准是工作区根目录，不是.vscode/所在位置，写".vscode/**"是错的，应写"**/.vscode/**" - 启用
"editor.formatOnSave": true时，务必同步指定"editor.defaultFormatter"，否则 Prettier 和 ESLint 冲突会导致保存无反应，还不会报错
协作时要不要提交 .vscode/settings.json
要，但只提交项目必需的、与代码质量或构建流程强相关的配置。个人偏好类设置（比如字体大小、主题、窗口缩放）绝不能进 Git。
团队共用的配置一旦缺失，就会触发“在我机器上是好的”问题。但提交前必须人工核对，因为 VSCode 不会阻止你把用户级专属项（如 workbench.colorTheme）一起塞进去——它虽然无效，却会污染版本历史。
- 建议提交的项：
editor.tabSize、editor.insertSpaces、files.trimTrailingWhitespace、python.defaultInterpreterPath、eslint.validate - 禁止提交的项：
editor.fontSize、window.zoomLevel、workbench.colorTheme、任何含绝对路径或本地用户名的值 -
.vscode/默认被 Git 忽略，需手动在项目根目录的.gitignore里删掉.vscode/这一行，或显式添加!.vscode/settings.json
"[javascript]": { "editor.fontSize": 14 } 看似合理，但它在工作区 settings.json 中不会生效，必须通过命令面板执行 Preferences: Configure Language Specific Settings 单独生成对应语言块，或者手动确保结构符合 VSCode 对语言作用域配置的解析要求。
