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）← 项目级，优先级最高

关键区别

文件	机制	行为
`settings.json`	增量覆盖	只写3项 → 继承用户级其余7项
`extensions.json`	全量清单	只写a,b,c → 只推荐a,b,c，不继承其他
`launch.json`	全量配置	只显示配置的调试方案
`tasks.json`	全量配置	只显示定义的任务
`snippets/*.json`	全量配置	只提供定义的代码片段

示例对比

settings.json（增量）

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

extensions.json（全量）

// 用户级：安装了 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/`	同左

项目级配置

位置：.vscode/ 目录下
作用范围：仅当前项目
版本控制：应提交到 Git，确保团队一致

四、扩展管理

用户级 vs 项目级

级别	存储位置	特点
用户级扩展	`~/.vscode/extensions/`	所有项目共享，物理安装在此
项目级推荐	`.vscode/extensions.json`	仅提示安装，不自动部署
真正隔离	Dev Container	容器内独立安装扩展

扩展推荐配置

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

多项目扩展隔离方案

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

我的 VSCode 扩展清单

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

分享我日常使用的 VSCode 扩展，按用途分类整理。

Python 开发

Black Formatter — Python 代码格式化工具，统一代码风格
Pylance — Python 语言服务器，提供智能提示和类型检查
Python — Python 核心扩展，集成调试和代码检查
Python Environments — 统一管理 Python 解释器和虚拟环境

Markdown 和笔记

Markdown All in One — 快捷键、目录、自动预览等 Markdown 全能工具
Markdown Notebook — Notebook 模式编辑 Markdown
Markdown Preview Enhanced — 增强预览，支持公式、图表、导出
Markmap — 将 Markdown 转换为思维导图
Foam — 基于 Markdown 和 Wikilink 的知识管理工具
dendron — 层级化笔记工具
Front Matter CMS — 内置 CMS，支持 Hugo、Jekyll 等静态站点

数据文件

Excel Viewer — 查看和编辑 Excel 表格
SQLite Viewer — 查看和管理 SQLite 数据库

主题和图标

Maple Theme — 彩色主题，亮/暗模式，低饱和度
Material Icon Theme — Material Design 文件图标

工具和实用程序

Chinese (Simplified) Language Pack — 简体中文语言包
Even Better TOML — TOML 配置文件支持
Open — 用系统默认程序打开当前文件
Prettier — 多语言代码格式化
Remote - SSH — 远程连接服务器编辑文件

记账

Beancount — 复式记账工具 Beancount 的 VSCode 支持扩展
Beancount Formatter — Beancount 记账文件格式化工具

AI 编程助手

Tencent Cloud CodeBuddy — 腾讯云 AI 编程助手

VSCode on 数字花园 | Mlosun.com

VSCode 配置机制完整笔记

一、.vscode 目录概述

常见文件结构

二、配置层级与覆盖机制

三层架构（优先级由低到高）

关键区别

示例对比

settings.json（增量）

extensions.json（全量）

三、配置存储位置

用户级配置

项目级配置

四、扩展管理

用户级 vs 项目级

扩展推荐配置

多项目扩展隔离方案

我的 VSCode 扩展清单

Python 开发

Markdown 和笔记

数据文件

主题和图标

工具和实用程序

记账

AI 编程助手