VSCode 配置应分三层：工作区配置（.vscode/settings.json）管项目专属规则，用户设置（settings.json）管通用偏好，扩展推荐（.vscode/extensions.json）管团队协作；配合符号链接可复用模板。
不用为每个项目单独配环境，一个 VSCode 配置文件就能覆盖多数开发场景——关键不是“全写进一个文件”，而是用好 工作区配置 + 设置同步 + 扩展推荐 这三层组合。
工作区配置（.vscode/settings.json）管项目专属规则
这是最常被忽略但最实用的一层。把项目级设置（比如 ESLint 路径、Python 解释器、缩进风格）放在项目根目录的 .vscode/settings.json 里，VSCode 会自动识别并只对当前项目生效。
- 它优先级高于用户全局设置，适合团队统一代码规范（如强制双引号、禁用 console）
- 配合
"editor.formatOnSave": true和对应语言的 formatter 扩展，保存即格式化，不依赖个人习惯 - 敏感配置（如本地调试端口、密钥路径）可写进
.vscode/settings.json，再加进.gitignore规避误提交
用户设置（settings.json）管通用偏好
把真正跨项目的习惯性设置放这里：字体大小、自动保存、侧边栏宽度、常用快捷键映射等。这些和语言、框架无关，改一次，所有项目都受益。
- 用 VSCode 的“设置”界面修改后，点右上角“复制配置”就能导出 JSON 片段，粘贴进你的备份 settings.json
- 避免写死绝对路径（比如
"python.defaultInterpreterPath"），这类应交给工作区或 .env 管理 - 开启
"workbench.settings.syncEnabled": true，登录 GitHub 账号后自动同步用户设置到新设备
扩展推荐（.vscode/extensions.json）管团队一致性
在项目根目录放一个 .vscode/extensions.json，声明推荐或必需的扩展。新成员克隆项目后，VSCode 会弹窗提示安装，点一下就齐活。
- 格式：
{"recommendations": ["esbenp.prettier-vscode", "ms-python.python"]} - 区分
"recommendations"（建议安装）和"unwantedRecommendations"（明确禁用某些干扰插件） - 前端项目可加
"redhat.vscode-yaml"，Python 项目加"ms-toolsai.jupyter"，按需组合不臃肿
小技巧：用符号链接复用配置
如果你有多个本地项目，又不想重复复制 .vscode 文件夹，可以用系统符号链接指向同一份配置模板。
- macOS/Linux：
ln -s ~/dotfiles/vscode-settings/.vscode ./my-project/.vscode - Windows（管理员 PowerShell）：
cmd /c mklink /D .vscode C:\dotfiles\vscode-settings\.vscode - 改一处，所有链接项目实时生效，且不影响 Git 提交（因为 .vscode 是真实存在的目录）
基本上就这些。不需要魔改 VSCode 源码，也不用装一堆配置管理插件。核心是分清“谁该管什么”——工作区管项目，用户设置管人，扩展推荐管协作。配置本身不复杂，容易忽略的是分层意识。
