必须通过File→Open Folder打开项目根目录，且窗口左下角显示“工作区”、设置界面切换到Workspace标签页有内容，才表明VSCode已识别为工作区；.vscode/settings.json必须位于该根目录下且文件名全小写，否则被忽略。
怎么确认 VSCode 已识别为工作区
不是“装完就能用”，而是必须让 VSCode 明确知道你在操作一个项目根目录。右下角状态栏没显示 工作区，就说明当前是单文件或用户级模式，.vscode/settings.json 会被完全忽略。
验证方式只有两个硬指标：
• 窗口左下角状态栏显示 工作区（不是“用户”）
• 设置界面右上角切换到 Workspace 标签页后有内容（不是空白或提示“未在工作区中”）
- 必须通过
File → Open Folder…打开项目最外层文件夹，不能右键单个.py或.js文件“在 VSCode 中打开” -
.vscode文件夹必须直接放在你打开的那个文件夹里，比如你打开的是/my-project，那.vscode/settings.json就得在/my-project/.vscode/settings.json - 文件名必须全小写：
settings.json✅，Settings.json❌，.VSCode❌
如何安全地创建和编辑 settings.json
手动新建容易出错，推荐优先用设置界面生成；但一旦要手写，就得避开几个致命坑。
- 不要用
Ctrl+,后直接点「Edit in settings.json」——那默认打开的是用户级配置，写进去就全局生效了 - 正确做法：搜索框输入目标项（如
python.defaultInterpreterPath），找到后点击右侧的?图标 → 「Add to Workspace Settings」，VSCode 会自动生成合法 JSON - 手写时禁用所有注释：
//或/* */会导致整个settings.json被静默忽略（JSONC 不被支持） - 空对象也得是合法 JSON：
{}✅，{ // comment }❌，{ "editor.tabSize": 2, }（末尾逗号）❌
哪些配置该放、哪些绝对不该放
放错地方不仅无效，还会污染团队协作或覆盖他人偏好。
- 必须放（项目强依赖）：
python.defaultInterpreterPath（指向./venv/bin/python）、eslint.enable、prettier.requireConfig、files.exclude（如"**/dist"）、editor.codeActionsOnSave - 语言专属配置必须加方括号：
"[javascript]": { "editor.tabSize": 2 }✅，直接写"editor.tabSize": 2是全局生效 ❌ - 绝对不该放：
workbench.colorTheme、editor.fontSize、keybindings.json—— 这些属于个人习惯，强行写进工作区会强制改别人主题或字体 - 某些设置根本不能被工作区覆盖，比如
telemetry.enableTelemetry，搜索时右侧图标灰显即表示不支持
多项目共存时怎么避免配置打架
一个窗口开多个项目（.code-workspace）时，.vscode/settings.json 不再起作用，所有配置必须统一收口到 .code-workspace 文件里。
- 先执行
File → Save Workspace As…生成my-app.code-workspace，否则所有添加的文件夹都是临时的，关窗就丢 -
settings字段写在.code-workspace顶层，不是每个子项目单独建.vscode - 路径变量要严格匹配：
${workspaceFolder:backend}中的backend必须和"folders": [{ "path": "backend" }]里的最后一级目录名完全一致 - 终端初始路径、环境变量等隐形配置也得在这儿设：
"terminal.integrated.cwd": "${workspaceFolder:frontend}"
真正难的不是写几行 JSON，而是理解 VSCode 加载链条：它只在以文件夹方式打开时才找 .vscode/settings.json → 再叠加 .code-workspace 里的 settings → 最后才 fallback 到用户设置。中间任一环节断了，你就以为“配置失效”，其实是压根没读到那一层。
