VSCode工作区设置需满足三条件：项目以文件夹模式打开、settings.json置于根目录且格式合法、设置项支持Workspace级覆盖（UI中图标显示Workspace）；terminal.cwd等路径变量需用${workspaceFolder}等安全写法，禁用预览与复用需同时关闭两个开关。
VSCode 的“默认行为”不是铁板一块，绝大多数都能被覆盖——但必须清楚哪些能动、怎么动、动了之后会连锁影响什么。
哪些设置支持工作区级覆盖
不是所有设置都买工作区配置的账。比如 workbench.startupEditor 或 window.zoomLevel 写进 .vscode/settings.json 会被静默忽略；而 editor.tabSize、files.trimTrailingWhitespace、python.defaultInterpreterPath 就可以。
- 判断依据：在设置 UI 搜索目标项，右侧图标显示 Workspace 表示支持工作区覆盖，User 表示只允许全局设置
- 语言相关配置（如 Python 解释器路径）必须用相对路径或
${workspaceFolder}变量，否则跨机器失效 -
terminal.integrated.cwd支持工作区覆盖，且常用值如"${workspaceFolder}/src"或"${userHome}/dev"都有效
为什么 .vscode/settings.json 没生效
最常见原因是 VSCode 根本没把它当工作区读——你可能只是打开了单个文件，而不是以文件夹模式启动。
- 检查左下角状态栏：必须显示 Folder: xxx，而非 No folder opened 或仅文件名
-
.vscode/settings.json必须放在项目根目录，且 JSON 格式合法（VSCode 有时不报错但直接跳过） - 某些扩展（如 ESLint、Prettier）会读取自己的配置字段（如
eslint.validate），这些字段也需写在settings.json中才生效，不能只靠扩展自带默认值
覆盖预览标签和编辑器复用逻辑
单击文件覆盖当前标签页，本质是 workbench.editor.enablePreview 和 workbench.editor.reuseEditors 两个开关共同作用的结果，关一个只能缓解，关两个才彻底解决。
-
"workbench.editor.enablePreview": false→ 关闭预览模式，所有单击都新开常驻标签页 -
"workbench.editor.reuseEditors": false→ 关闭复用逻辑，双击同一文件也会新开标签页（注意：这会导致多个同名标签并存） - 二者同时设为
false后，Ctrl+Click 跳转定义仍保持原行为（强制在当前标签内打开），不受影响
终端默认目录被覆盖后的行为细节
terminal.integrated.cwd 看似简单，但路径变量展开时机和 fallback 行为容易踩坑。
-
"${workspaceFolder}"在未打开文件夹时会退回到用户主目录，不是报错而是静默降级 -
"${env:HOME}"和"${userHome}"效果一致，但前者依赖系统环境变量，后者由 VSCode 自行解析，更稳定 - Windows 下写绝对路径要用双反斜杠或正斜杠：
"C:/Projects/myapp"可用，"C:\Projects\myapp"会因转义失败变成无效路径
真正麻烦的不是改哪一项，而是改完之后其他扩展或快捷键是否还按预期响应——比如禁用预览后，某些插件的“快速打开”逻辑可能假定预览存在，得同步检查它们的文档。
