VSCode工作区设置失效主因是未以文件夹模式打开项目，需通过code /path/to/project或File→Open Folder…启动并确认状态栏显示“Folder: project-name”；.vscode/settings.json须置于根目录且格式正确；仅部分设置支持工作区级覆盖，可通过设置UI图标判断作用域；语言相关配置如Python解释器路径需用相对路径或${workspaceFolder}变量；协作时应提交项目必需配置（如tabSize、trimTrailingWhitespace），禁用个人偏好项。
工作区设置为什么没生效
VSCode 的工作区配置（.vscode/settings.json）优先级确实高于全局设置，但前提是它被正确识别为“工作区”——不是随便打开一个文件夹就能触发。常见失效原因是：你用 code some-file.js 直接打开了单个文件，VSCode 启动的是“空工作区”，此时 .vscode/settings.json 根本不加载。
- 必须通过
code /path/to/project打开整个文件夹，或在 VSCode 内使用 File → Open Folder… - 检查左下角状态栏：如果显示
Folder: project-name，说明是工作区模式；若显示No folder opened或只显示文件名，配置不会生效 -
.vscode/settings.json文件必须放在项目根目录，且 JSON 格式合法（VSCode 会提示语法错误，但有时静默忽略）
settings.json 中哪些配置能被覆盖，哪些不能
不是所有设置都支持工作区级覆盖。VSCode 把设置按作用域分三类：用户级（全局）、工作区级（文件夹）、远程/扩展级。部分设置强制锁定在用户级，比如 update.mode、telemetry.enableTelemetry，写进工作区也会被无视。
- 可覆盖的典型项：
"editor.tabSize"、"files.exclude"、"eslint.validate"、"python.defaultInterpreterPath" - 不可覆盖的常见项：
"workbench.startupEditor"、"window.zoomLevel"、"extensions.ignoreRecommendations" - 不确定某项是否支持？在设置 UI 搜索该配置，右侧图标显示
Workspace表示可用，User表示仅限全局
如何让不同项目自动切换 Node.js 版本或 Python 解释器
这类配置本质是“语言特定 + 工作区绑定”，靠 settings.json 配合路径和扩展行为实现，不是 VSCode 原生功能，而是由对应语言扩展（如 Python 扩展、ESLint 扩展）读取并响应。
- Python：在
.vscode/settings.json中写"python.defaultInterpreterPath": "./venv/bin/python"（Linux/macOS）或"./venv/Scripts/python.exe"（Windows），路径需相对于工作区根目录 - Node.js：没有直接等效配置，但可通过
"eslint.runtime"或"typescript.preferences.includePackageJsonAutoImports"间接影响；更可靠的做法是配合.nvmrc或.node-version文件 + 插件（如 `pflannery.vscode-versionlens`） - 注意：路径必须存在且可执行，否则扩展会回退到全局默认，不报错也不提示
多人协作时 .vscode/settings.json 该不该提交
该提交，但只提交**与项目强相关、非个人偏好的配置**。很多人误以为“所有设置都不该进 Git”，结果导致团队里缩进不一致、ESLint 规则不生效、隐藏文件列表不统一。
- 推荐提交：
"editor.tabSize"、"files.trimTrailingWhitespace"、"eslint.packageManager"、"prettier.requireConfig" - 禁止提交：
"editor.fontSize"、"workbench.colorTheme"、"terminal.integrated.fontSize"（纯个人视觉偏好） - 敏感路径别硬编码：比如
"python.defaultInterpreterPath"如果指向绝对路径（/home/xxx/...），务必改成相对路径或用${workspaceFolder}变量
最常被忽略的一点：工作区设置只对打开该文件夹的人生效，但如果你把 .vscode/settings.json 提交了，新成员 clone 后第一次打开文件夹就会自动应用——这正是它该起的作用。别因为怕“覆盖别人习惯”就全删掉，关键在筛选哪些真属于项目契约。
