VSCode缩进设置需修改editor.tabSize并禁用editor.detectIndentation,推荐通过settings.json配置全局及语言专属规则,配合.editorconfig或Prettier实现团队统一。

全局设置里改 editor.tabSize 就够了
VSCode 的制表符大小由 editor.tabSize 控制,改它就能决定按 Tab 键或自动缩进时占几个空格宽度。这个值默认是 4,改成 2、3 或 8 都可以,但注意:它只在 editor.insertSpaces 为 true(默认)时直观表现为“几个空格”;若设为 false,它控制的是真实 \t 字符的显示宽度,实际文件里还是一个字符。
别让 editor.detectIndentation 覆盖你的设置
VSCode 默认开启 editor.detectIndentation,它会扫描文件前几行缩进,自动覆盖你设的 tabSize 和 insertSpaces。结果就是:你明明全局设了 2 空格,打开一个用 4 空格缩进的旧文件,右下角突然变成 Spaces: 4,而且改不回来。
- 去设置里搜
editor.detectIndentation,直接取消勾选 - 或者在
settings.json里加一行:"editor.detectIndentation": false - 这步不做,很多“设置不生效”的问题都源于此
通过 settings.json 修改最稳,且支持语言级覆盖
图形界面设置有时不同步,直接编辑 settings.json 更可靠,还能按语言单独配置。比如 Python 项目习惯用 4 空格,而 JSON/Markdown 常用 2 空格。
打开命令面板(Ctrl+Shift+P 或 Cmd+Shift+P),输入并选择 Preferences: Open Settings (JSON),然后写:
{
"editor.tabSize": 2,
"editor.insertSpaces": true,
"editor.detectIndentation": false,
"[python]": {
"editor.tabSize": 4
}
}
注意:[python] 这种语言专属块优先级高于全局设置,但低于项目根目录下的 .editorconfig。
右下角状态栏只是临时切换,关掉文件就重置
点击右下角的 Spaces: 2 或 Tab Size: 4 可以快速调当前文件的缩进,但它不改任何设置,只影响当前编辑器实例。
- 选 “Convert Indentation to Spaces” 是把全文所有
\t替换成空格,慎用——可能破坏已有格式或 Git diff - 点数字改大小,下次打开该文件时仍会重新检测或读取设置,不会记住这次修改
- 真要持久生效,必须走
settings.json或关闭detectIndentation
最常被忽略的一点:团队协作时,单靠 VSCode 设置无法保证所有人一致,得配合 .editorconfig 或 Prettier 的 formatOnSave 才算真正落地。


















