答案:通过齿轮图标进入设置并点击右上角花括号图标可打开settings.json,该文件以JSON格式配置编辑器行为,支持用户级和工作区级设置,如缩进、字体、自动保存等,需注意语法正确性。

VSCode 的 settings.json 文件用于自定义编辑器行为,比如字体大小、缩进设置、文件排除等。它有两种级别:用户级和工作区级(项目级)。用户级配置全局生效,工作区级只对当前项目生效。
如何打开 settings.json
点击左下角齿轮图标 → 选择“设置” → 点右上角的“打开设置 (JSON)”图标(一个带花括号的文件图标),即可打开 settings.json 文件。
基本结构与写法
settings.json 是标准的 JSON 格式,使用键值对方式配置:
{
"editor.tabSize": 2,
"editor.insertSpaces": true,
"files.autoSave": "onFocusChange",
"files.exclude": {
"**/.git": true,
"**/node_modules": true
}
}
常见配置项说明:
- editor.tabSize:设置缩进空格数
- editor.insertSpaces:按 Tab 键时插入空格而不是制表符
- editor.fontSize:编辑器字体大小
- files.autoSave:自动保存策略,可选 "off"、"afterDelay"、"onFocusChange"、"onWindowChange"
- files.exclude:在资源管理器中隐藏指定文件或目录
- search.exclude:搜索时忽略的文件或目录
- editor.renderWhitespace:是否显示空白字符,设为 "all" 可见空格和换行
- editor.wordWrap:控制文字换行,可设为 "on"、"off" 或 "wordWrapColumn"
项目专属配置示例
在项目根目录创建 .vscode/settings.json,内容如下:
{
"editor.tabSize": 4,
"editor.detectIndentation": false,
"python.defaultInterpreterPath": "./venv/bin/python",
"search.exclude": {
"**/dist": true,
"**/build": true
},
"recommendations": [
"ms-python.python"
]
}
这个配置让该项目使用 4 空格缩进,禁用自动检测缩进,指定 Python 解释器路径,并推荐安装特定扩展。
注意事项
确保 JSON 格式正确,不能有尾随逗号、注释或单引号。虽然 VSCode 允许你在 JSON 中写注释(实际是支持 C 风格注释的 JSON 变体),但必须保持结构合法。
例如,下面写法是错误的:
{
"editor.tabSize": 2,
"files.autoSave": "onFocusChange", // 这里不能有注释(虽然有时能运行,但不推荐)
}
应改为:
{
"editor.tabSize": 2,
"files.autoSave": "onFocusChange"
}
基本上就这些。改完保存后,大多数设置会立即生效。










