settings.json 是 VSCode 的核心配置文件,用于精确自定义编辑器行为;需通过 Cmd+, 打开并编辑,遵循 JSON 语法,可添加通用及扩展专属配置,并区分用户级与工作区级设置。

如果您希望自定义 Visual Studio Code 的行为、界面和功能,settings.json 文件是核心配置入口。通过直接编辑该文件,您可以精确控制编辑器的每一个可配置项。以下是深入操作 settings.json 的详细步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、定位并打开 settings.json 文件
VSCode 的用户设置以 JSON 格式存储,优先级高于默认设置和工作区设置。手动编辑该文件可绕过图形界面限制,启用高级或隐藏配置项。
1、启动 VSCode,按下 Cmd + ,(Windows/Linux 为 Ctrl + ,)打开设置界面。
2、在设置界面右上角点击 “打开设置(JSON)” 图标(一个带有大括号 {} 的方形按钮)。
3、此时将打开用户级别的 settings.json 文件,路径通常为 ~/Library/Application Support/Code/User/settings.json(macOS)。
二、理解 settings.json 的结构与语法规范
该文件必须严格遵循 JSON 语法:键名必须用双引号包裹,值支持字符串、布尔值、数字、数组和嵌套对象,末尾不可有逗号,注释不被原生支持(但 VSCode 允许行内 // 和块注释 /* */ 作为扩展语法)。
1、检查当前文件是否以 { 开头、以 } 结尾,且无语法错误高亮(若有红色波浪线,说明存在非法字符或格式错误)。
2、在任意键值对后添加一行 // 这是合法的注释 ,验证 VSCode 对注释的支持性。
3、尝试输入一个未闭合的引号,观察编辑器是否立即标出语法错误,确认 JSON 校验已启用。
三、添加常用个性化配置项
直接写入键值对可覆盖默认行为。每个配置项需符合 VSCode 官方文档中定义的 schema 类型,否则可能被忽略或触发警告。
1、在花括号内部插入以下内容(确保位于其他键值对之间,且前一行末尾有逗号):
“editor.fontSize”: 15,
“workbench.colorTheme”: “Night Owl”,
“files.autoSave”: “onFocusChange”,
2、保存文件(Cmd + S),观察侧边栏颜色主题是否实时切换,编辑器字体大小是否变化。
3、新建一个 .txt 文件并输入文字,移出编辑器焦点,确认文件是否自动保存。
四、启用扩展专属配置
已安装的扩展常注册自己的配置节,这些配置必须按扩展定义的 key 路径写入,否则无效。例如 Prettier、ESLint、Python 扩展均有独立命名空间。
1、在 settings.json 中找到或新增 “prettier.semi” 键,设其值为 false 以禁用分号。
2、添加 “python.defaultInterpreterPath”,值设为 “/usr/local/bin/python3”(请替换为本机实际路径)。
3、添加 “eslint.enable” 并设为 true,确保 ESLint 在打开 JS/TS 文件时激活。
五、区分用户设置与工作区设置
工作区设置(.vscode/settings.json)作用于当前文件夹及其子目录,优先级高于用户设置,适合项目级定制。二者结构相同,但存放位置和影响范围不同。
1、在当前项目根目录下创建名为 .vscode 的文件夹(注意开头的点)。
2、在该文件夹内新建文件,命名为 settings.json。
3、写入仅适用于该项目的配置,例如:“editor.tabSize”: 2 和 “files.exclude”: {“**/__pycache__”: true}。