settings.json是VS Code核心配置文件,通过键值对实现个性化设置,支持用户、工作区、文件夹三级配置,优先级逐级覆盖。

想让 VS Code 完全按你的习惯工作?settings.json 是关键。它比图形界面设置更灵活、更强大,能实现精细化控制。这篇文章带你彻底理解它的结构和用法,不再对一堆 JSON 配置感到困惑。
settings.json 是什么?
VS Code 的设置默认以图形化方式展示在“设置”面板中,但背后其实是一个名为 settings.json 的文件在管理所有配置。你可以通过以下方式打开它:
- 快捷键 Ctrl + , 打开设置,然后点击右上角的“打开设置 (JSON)”图标
- 命令面板输入 Preferences: Open Settings (JSON)
这个文件是一个标准的 JSON 格式文件,由大括号包裹,内部是键值对结构。
基本结构:键值对配置
每个设置项都是一个键值对,格式如下:
{ "editor.tabSize": 2, "files.autoSave": "onFocusChange", "workbench.colorTheme": "Visual Studio Dark" }说明:
-
键(Key):代表具体的设置项,如
editor.tabSize控制编辑器缩进大小 - 值(Value):可以是字符串、数字、布尔值(true/false)、数组或对象
常见类型示例:
-
字符串:
"files.defaultLanguage": "javascript" -
数字:
"editor.fontSize": 14 -
布尔值:
"editor.wordWrap": true -
数组:
"files.associations": ["*.log", "*.txt"] -
对象:
"emmet.syntaxProfiles": { "html": "xhtml" }
作用范围:用户、工作区与文件夹
VS Code 支持多层级配置,优先级从高到低为:
-
文件夹设置:项目根目录下的
.vscode/settings.json,只影响当前项目 - 工作区设置:适用于多个文件夹组成的 .code-workspace 文件中的 settings 部分
- 用户设置:全局生效,位于系统配置目录中(如 macOS 的 ~/Library/Application Support/Code/User/settings.json)
如果你希望团队统一代码风格,把 settings.json 放进项目的 .vscode 目录并提交到 Git,其他人克隆后自动生效。
常用配置场景举例
掌握结构后,可以轻松实现个性化配置:
-
统一缩进:
"editor.detectIndentation": false, "editor.tabSize": 2 -
保存时格式化:
"editor.formatOnSave": true -
隐藏不需要的文件:
"files.exclude": { "**/.git": true, "**/*.log": true } -
指定语言关联:
"files.associations": { "*.conf": "ini", "*.js": "javascriptreact" } -
启用 ESLint 自动修复:
"eslint.autoFixOnSave": true
只要在官方文档查到设置项名称,就可以直接写进 JSON 中生效。
基本上就这些。理解了键值结构、数据类型和作用范围,你就能自由定制 VS Code,让它真正成为你的专属编辑器。不复杂,但容易忽略细节。










