直接编辑settings.json可精确控制VS Code行为,实现跨设备同步与版本管理。通过"Preferences: Open Settings (JSON)"打开文件,左侧设用户级通用配置,右侧配项目专属规则。常用配置包括:统一缩进为2空格、保存时自动格式化并修复ESLint错误;过滤node_modules等无关文件;自定义终端Shell和Python解释器路径;利用${workspaceFolder}变量实现动态配置;控制Prettier等插件行为。合理配置能显著提升开发效率,将工具深度个性化为工作流的一部分。

想让 VS Code 完全听你指挥?关键不在插件,而在 settings.json。图形界面设置只能触及表面,真正掌控编辑器行为、提升效率的钥匙,藏在这一份看似简单的 JSON 文件里。
为什么必须用 settings.json?
VS Code 提供图形化设置面板,方便新手上手。但当你需要精细控制或批量配置时,图形界面就显得力不从心。直接编辑 settings.json 的优势包括:
- 精确控制:支持图形界面未暴露的隐藏选项
- 快速复制:跨设备迁移配置只需同步一个文件
- 版本管理:可将配置纳入 Git,追踪变更历史
- 避免误点:防止他人或自己不小心改错设置
如何打开和编辑 settings.json
按下 Ctrl + Shift + P(Mac 上是 Cmd + Shift + P),输入 “Preferences: Open Settings (JSON)”,回车即可进入编辑界面。你会看到两个面板:
- 左侧是用户级配置,影响所有项目
- 右侧是工作区配置(.vscode/settings.json),仅对当前项目生效
优先使用用户配置做通用设定,项目专属规则(如缩进风格、端口)放在工作区配置中。
高效配置实战技巧
真正的大师懂得用配置解决实际问题。以下是一些高频且实用的 settings.json 配置项:
1. 编辑体验优化{
"editor.tabSize": 2,
"editor.insertSpaces": true,
"editor.renderWhitespace": "boundary",
"editor.wordWrap": "on",
"editor.formatOnSave": true,
"editor.codeActionsOnSave": {
"source.fixAll.eslint": true
}
}
统一缩进为 2 空格,保存时自动格式化并修复 ESLint 错误,减少团队协作中的代码风格争议。
2. 文件与搜索过滤{
"files.exclude": {
"**/.git": true,
"**/node_modules": true,
"**/*.log": true
},
"search.exclude": {
"**/dist": true,
"**/build": true
}
}
隐藏无关文件,让资源管理器和全局搜索更清爽,聚焦核心代码。
{
"terminal.integrated.shell.linux": "/bin/zsh",
"terminal.integrated.fontSize": 14,
"python.defaultInterpreterPath": "./venv/bin/python"
}
指定默认 Shell 和 Python 解释器路径,避免每次手动切换。
高级技巧:条件配置与变量
VS Code 支持使用变量实现动态配置。例如:
{
"python.terminal.activateEnvironment": false,
"cmake.buildDirectory": "${workspaceFolder}/build"
}
其中 ${workspaceFolder} 会自动替换为当前项目根路径,适合多项目复用配置。
还可以通过 settings.json 控制扩展行为。比如 Prettier 插件:
{
"prettier.requireConfig": false,
"prettier.useEditorConfig": false
}
强制其忽略 .editorconfig,完全遵循你在 VS Code 中设定的格式规则。
基本上就这些。掌握 settings.json 不是为了炫技,而是为了把工具变成你思维的延伸。花一小时系统梳理一次配置,可能换来未来几年每天节省十分钟。不复杂,但容易忽略。










