工作区配置需将.settings.json置于项目根目录.vscode文件夹中才生效，扩展推荐需通过.vscode/extensions.json的”recommendations”字段声明，且须与settings.json中对应扩展配置协同使用。
工作区配置文件 .vscode/settings.json 怎么写才生效
VSCode 的工作区配置优先级高于用户级设置，但必须放在项目根目录下的 .vscode 文件夹里，且文件名严格为 settings.json。如果放错位置（比如放在子目录或命名成 workspace.json），VSCode 完全忽略它。
常见错误是直接编辑用户设置（settings.json 在全局配置路径下），结果所有项目都套用同一套规则。工作区配置只对当前打开的文件夹/工作区起作用。
- 确保项目根目录存在
.vscode目录，不是.vs-code或vscode - 配置项不加注释（JSON 标准不支持），否则 VSCode 启动时报错
Invalid configuration file - 路径类配置（如
files.exclude）中的路径是相对于工作区根目录的，不是相对于.vscode - 若同时打开多文件夹工作区（.code-workspace），配置应写在
.code-workspace文件的"settings"字段里，而非.vscode/settings.json
怎么让团队成员自动看到推荐扩展 extensions.json
VSCode 不会自动安装扩展，但能通过 .vscode/extensions.json 提示成员“建议安装哪些扩展”。这个文件本身不触发安装，只影响 VSCode 窗口右下角的「Extensions」提示气泡和 Extensions 视图里的 “Recommended” 标签页。
它只在你用该工作区首次打开 VSCode 时弹出一次提示；后续不会反复打扰，也不会覆盖用户已禁用的扩展。
-
extensions.json必须包含"recommendations"字段，值为字符串数组，每个元素是publisher.name格式，例如"esbenp.prettier-vscode" - 不要写错大小写或空格——
"prettier.vscode"或"Prettier"都无效 - 如果某扩展在 Marketplace 已下架或 ID 变更，推荐条目会静默失效，VSCode 不报错也不提醒
- 想强制要求（非推荐），需配合脚本或 CI 检查，VSCode 原生不支持“必须安装”逻辑
工作区配置和扩展推荐如何协同解决实际问题
典型场景：一个 typescript + react 项目需要 Prettier 格式化、ESLint 校验、以及特定的 typescript.preferences.includePackageJsonAutoImports 行为。这些不能靠“装了插件就自动好”，必须配对落地。
例如，仅推荐 esbenp.prettier-vscode 不够——还得在 settings.json 中指定 "editor.defaultFormatter": "esbenp.prettier-vscode"，否则保存时不会触发格式化。
- ESLint 扩展推荐后，必须配
"eslint.enable": true和"eslint.validate"，否则不检查 .tsx 文件 - 某些扩展（如
ms-python.python）依赖工作区级python.defaultInterpreterPath，否则调试时找不到解释器 - 前端项目常需
"emeraldwalk.runonsave"类扩展，但它的触发命令（如npm run lint）路径必须用${workspaceFolder}而非.，否则在多根工作区中失效
为什么改了配置没反应？几个关键检查点
最常被忽略的是配置继承链和作用域冲突。VSCode 设置分用户、远程、工作区、文件夹（多根）、语言专属五层，高优先级设置可能被低优先级覆盖，也可能被语言特定设置劫持。
- 按
Ctrl+,打开设置界面，右上角切换到Workspace标签页，确认你编辑的是当前工作区设置，而不是 User - 搜索某个配置项（如
files.trimTrailingWhitespace），看右侧是否显示Workspace图标点亮——没点亮说明没生效 - 在编辑器中右键 →
Open Settings (JSON)，检查打开的是否为.vscode/settings.json，而不是用户级路径下的文件 - 某些设置（如
editor.fontSize）支持“语言特定”覆盖，若你在"[typescript]"块里设了不同值，它会优先生效，掩盖工作区通用设置
工作区配置不是魔法，它只是 JSON 数据源；真正起作用的是扩展是否读取并响应这些字段。别假设“配了就管用”，先看对应扩展文档里是否明确支持该配置项。