VS Code配置不生效的最常见原因是被更高优先级设置覆盖，其配置层级为：默认设置＜用户设置＜工作区设置＜语言特定设置＜命令行参数。
工作区设置不是“多加个文件”就完事的，它必须和项目实际运行逻辑对齐，否则容易导致调试失败、任务不触发、格式化失效等静默问题。
为什么 settings.json 改了却没生效？
最常见原因是配置被更高优先级或同级但更具体的设置覆盖。VSCode 的配置层级是：默认设置 settings.json 里写了 "editor.tabSize": 2，但同时又定义了 "[javascript]": { "editor.tabSize": 4 }，那 JavaScript 文件里实际就是 4 个空格。
另外要注意路径是否正确：.vscode/settings.json 必须放在你用 VSCode “打开文件夹”时选中的那个根目录下；如果误放在子目录里，它根本不会被加载。
- 检查是否真正在工作区模式下打开：看窗口标题栏是否有「工作区」字样，或按
Cmd+Shift+P（macOS）/Ctrl+Shift+P（Windows/Linux）输入Developer: Inspect Editor Tokens and Scopes，确认当前编辑器读取的是工作区而非用户设置 - 避免在
settings.json中写注释（JSON 标准不支持），VSCode 虽然容忍，但某些扩展或 CI 工具会报错 - 敏感值如本地路径、密钥绝对不要硬编码进
settings.json，改用${env:HOME}或${workspaceFolderBasename}等变量替代
launch.json 和 tasks.json 怎么配合项目结构？
这两个文件不是摆设，它们直接决定你点「启动调试」或按 Ctrl+Shift+B 时执行什么命令。关键在于路径变量是否指向真实可执行环境。
比如你的项目是 monorepo 结构：packages/frontend/ 和 packages/backend/，那么 packages/frontend/.vscode/launch.json 里的 "program" 就不能写死成 "./src/index.js"，而应明确为 "${workspaceFolder}/src/index.js" —— 否则 VSCode 会从整个工作区根目录去找，而不是从 frontend 子目录。
-
tasks.json中的"cwd"（current working directory）必须显式设置，尤其当构建脚本依赖package.json或node_modules位置时 - 多根工作区下，每个子文件夹的
.vscode是独立生效的，不要指望一个launch.json控制所有服务 - 调试 Node.js 时，
"runtimeExecutable"如果指向本地 nvm 安装的 node，得用${env:NVM_BIN}/node，否则可能因 shell 环境不一致而找不到二进制
如何让团队成员真正用上工作区配置？
把 .vscode/settings.json 提交到 Git 只是第一步。真正落地要解决三个现实问题：扩展推荐、信任提示、跨平台兼容。
比如你写了 "editor.defaultFormatter": "esbenp.prettier-vscode"，但团队有人没装这个插件，VSCode 不会自动装，只会静默跳过格式化。这时候就得靠 .vscode/extensions.json：
{
"recommendations": ["esbenp.prettier-vscode", "ms-python.python"]
}
此外，VSCode 1.85+ 默认对未信任工作区禁用调试和任务执行。大型项目第一次打开时，右下角弹出的「信任此工作区」提示不能跳过 —— 否则 launch.json 和 tasks.json 全部不工作。
- 在
settings.json中加入"security.workspace.trust.untrustedFiles": "open"可降低门槛，但仅限内部可信仓库 - Windows 和 macOS 下路径分隔符不同，
tasks.json中的"command"尽量用 cross-platform 工具（如 npm script），避免写"cmd /c build.bat"或"sh build.sh" - 不要在
settings.json中启用"files.autoSave": "afterDelay"这类可能干扰 CI 构建流程的选项，它会在你切 Tab 时偷偷保存，导致未完成代码被提交
最容易被忽略的其实是「工作区信任」和「语言特定设置嵌套」—— 前者不点确认，所有调试/任务都白配；后者一写错层级，格式化就只在部分文件生效。这两处不出问题，其他配置才有意义。
