Tab键插入行为由editor.insertSpaces、editor.tabSize和editor.detectIndentation三者共同决定：insertSpaces控制插空格还是\t，tabSize仅在前者为true时决定空格数，detectIndentation若为true会自动覆盖手动设置。
Tab 键插入行为由三个配置共同决定
VSCode 里按 Tab 键到底插空格还是 \t、插几个，不是单靠 editor.tabSize 就能控制的。真正起作用的是这三个配置的组合：
-
editor.insertSpaces：设为true插空格，false插真实\t -
editor.tabSize：只在insertSpaces: true时生效，表示插几个空格；设为false时它控制\t的显示宽度（不影响存储） -
editor.detectIndentation：默认true，会扫描文件首行缩进，自动覆盖你手动设的tabSize和insertSpaces—— 这是多数人改了没效果的根源
常见错误现象：settings.json 里写了 "editor.tabSize": 2，但按 Tab 还是插 4 个空格或 \t。大概率是 detectIndentation 在“猜”，或者语言专属设置把 insertSpaces 覆盖成了 false。
Convert Indentation to Spaces 是一次性操作，不改变设置
右下角状态栏点击 Tab Size: 4 或 Spaces: 2 后选 Convert Indentation to Spaces，这个命令只做一件事：把当前文件所有行首的 \t 替换成对应数量的空格（按当前 tabSize 值换算）。它不会改你的配置，也不处理字符串内或注释里的 \t。
- 触发前必须确保状态栏显示的是
Tab Size: N（即当前缩进模式是 Tab），否则菜单里压根不出现该选项 - 执行后不可撤销，没弹窗确认，建议先
Ctrl+S保存副本 - 它只解决“已有缩进混用”问题，不影响后续按
Tab的行为 —— 那得靠上面三个配置
Shift+Alt+F 格式化 ≠ 缩进重排，而是整块结构重写
Shift+Alt+F（Mac 是 Shift+Option+F）调用的是语言对应的格式化器（如 Prettier、ESLint、Volar），不是编辑器原生的缩进逻辑。它会读取项目级配置（比如 .prettierrc），再决定缩进用空格还是 Tab、宽度多少、括号位置等。
- 没装对应语言的格式化扩展，或没设
editor.defaultFormatter，快捷键就静默失败 - 即使全局设置了
editor.tabSize: 2，只要.prettierrc里写了"tabWidth": 4，格式化结果就是 4 空格 - HTML/JSON 等无语法上下文的文件，原生格式化器容易错位，必须配
prettier或js-beautify才可靠
语言专属配置比全局设置更优先也更安全
前端项目普遍要求 JS/TS 用 2 空格、Python 用 4 空格、Go 用 Tab，靠改全局 settings.json 很难兼顾。正确做法是用语言 ID 配置：
- 打开命令面板
Ctrl+Shift+P→ 输入Preferences: Configure Language Specific Settings - 选
javascript（不是.js），填入：{"[javascript]": {"editor.tabSize": 2, "editor.insertSpaces": true, "editor.detectIndentation": false}} - 同理配
[typescript]、[python]、[html]—— 这些配置会覆盖全局，且不受文件首行干扰
最容易被忽略的是 editor.detectIndentation: false：不关掉它，新开一个旧项目文件，VSCode 可能直接把你刚设的 2 空格改成 4 空格，只因第一行缩进是 4 个空格。
