.vscode/settings.json需通过file→open folder打开项目根目录才生效，右下角显示“工作区”且设置页切换至workspace标签为关键验证点；文件名必须全小写，禁用注释，仅支持workspace级配置项。
怎么让 .vscode/settings.json 真正生效
它不生效，90% 是打开方式错了，不是配置写得不对。VS Code 只在「以文件夹为单位打开」时才读取 .vscode/settings.json；右键单个 .py 或 .js 文件 →「在 VSCode 中打开」，进来的只是单文件模式，.vscode 完全被忽略。
必须通过 File → Open Folder… 打开项目根目录，且窗口左下角状态栏要显示 Workspace 标签。此时再检查资源管理器里有没有 .vscode/settings.json，右上角设置界面是否显示 Workspace —— 这两个是硬指标。
- 手动创建
.vscode/settings.json时，禁用所有注释（//或/* */），JSONC 不被支持，一有注释整文件就失效 - 配置项本身可能不支持工作区级覆盖，比如
workbench.colorTheme、editor.fontSize，这类设置强行写进settings.json会被静默忽略 - 多根工作区（
.code-workspace）里不能靠多个.vscode/settings.json分别控制，得统一写在.code-workspace的settings字段下，语言特定配置要用"[python]"这种语法包裹
settings.json 该放什么、不该放什么
工作区设置不是垃圾桶，乱塞会导致团队协作翻车或本地行为异常。核心原则：只放「项目强依赖」的配置，不放「个人偏好」。
- 必须放：
python.defaultInterpreterPath（指定虚拟环境）、eslint.enable（前端项目开启校验）、files.exclude（隐藏**/dist）、editor.codeActionsOnSave（保存时自动修复） - 不该放：
workbench.colorTheme（强制改别人主题）、keybindings.json（快捷键属于用户习惯）、editor.fontFamily（字体大小/家族因人而异） - 语言特定配置要加方括号，比如
"[javascript]": { "editor.tabSize": 2 }，直接写"editor.tabSize": 2是全局生效，不区分语言
搜索路径、终端环境这些“隐形配置”怎么管
很多人只记得改缩进和格式化，却漏掉搜索和终端这两块实际影响效率的关键项。它们同样走工作区优先逻辑，但配置路径和写法容易踩坑。
-
search.include和search.exclude支持${workspaceFolder}变量，比如只搜"${workspaceFolder}/src/**": true，避免误扫node_modules或构建产物 -
terminal.integrated.env.*按系统区分，Linux/macOS 用terminal.integrated.env.linux，Windows 用terminal.integrated.env.windows，值里可嵌套${env:HOME}或${workspaceFolder} -
terminal.integrated.env.linux里设PYTHONPATH或NODE_ENV，比每次手动source venv/bin/activate更可靠，且对集成任务（tasks.json）也生效
要不要把 .vscode 提交到 Git？
该提交，但得有选择地提交。目标不是备份你的全部设置，而是同步那些「不配好就跑不起来」的最小必要项。
- 推荐提交：
settings.json（删掉所有个人路径、密钥、绝对路径）、extensions.json（只列recommendations，不写unwantedRecommendations） - 禁止提交：
launch.json（含本地调试路径）、tasks.json（若含硬编码路径）、任何带token、secret、password的字段 - 提交前务必验证：换台干净机器克隆项目 → 用 VS Code 打开文件夹 → 看 ESLint 是否自动启用、Prettier 是否在保存时触发、终端里
echo $NODE_ENV是否输出预期值
最常被忽略的一点：语言特定配置（如 "[python]" 块）必须写在 settings.json 顶层，不能嵌套在其他对象里；否则 VS Code 根本识别不了，也不会报错，只会安静地当没这回事。
