VSCode 配置机制完整笔记

mlosun@qq.com (mlosun) — Mon, 09 Mar 2026 00:00:00 +0800

一、.vscode 目录概述

.vscode 是 VS Code 的项目级配置目录，定义"当 VS Code 打开这个项目时，该如何表现"。

.vscode/
├── settings.json # 工作区设置（覆盖用户全局设置）
├── extensions.json # 推荐安装的扩展列表
├── launch.json # 调试配置
├── tasks.json # 自定义任务
└── snippets/ # 代码片段目录

VS Code 默认设置
 ↓
用户级设置（~/settings.json）
 ↓
工作区设置（.vscode/settings.json）← 项目级，优先级最高

// 用户级：a=1, b=2, c=3, d=4, e=5
// 项目级写：{"b": 20}
// 结果：a=1, b=20, c=3, d=4, e=5（继承+覆盖）

// 用户级：安装了 a,b,c,d
// 项目级写：{"recommendations": ["a","b"]}
// 结果：只推荐 a,b（不会推荐 c,d）

类型	路径（macOS/Linux）	路径（Windows）
设置文件	`~/.config/Code/User/settings.json`	`%APPDATA%\Code\User\settings.json`
扩展目录	`~/.vscode/extensions/`	`%USERPROFILE%\.vscode\extensions\`
快捷键	`~/.config/Code/User/keybindings.json`	同左
代码片段	`~/.config/Code/User/snippets/`	同左

{
 "recommendations": ["dbaeumer.vscode-eslint", "esbenp.prettier-vscode"],
 "unwantedRecommendations": ["some.extension.to.disable"]
}

场景：项目A用a,b,c，项目B用d,e,f，其他项目用a,b,c,d