VSCode缩进混乱源于editor.insertSpaces、editor.detectIndentation和语言专属设置未对齐；真正决定按Tab键插入空格还是\t的是editor.insertSpaces，而非tabSize。
VSCode 缩进混乱不是编辑器坏了，而是 editor.insertSpaces、editor.detectIndentation 和语言专属设置三者没对齐——改错一个，其他两个就会悄悄覆盖你。
为什么改了 editor.tabSize 还是插 Tab 字符？
因为 editor.tabSize 只管“缩进显示多宽”，不管“按 Tab 键插什么”。真正决定插入空格还是 \t 的，只有 editor.insertSpaces 这一个开关。
-
editor.insertSpaces: true→ 按 Tab 插入空格（数量由editor.tabSize决定） -
editor.insertSpaces: false→ 按 Tab 插入单个\t字符，tabSize完全无效 - 即使全局设了
insertSpaces: true，如果当前文件是 Python，而[python]语言专属设置里写了"editor.insertSpaces": false，那它就插\t - 右下角状态栏显示
Tab Size: 4并不表示你在用空格——要看它写的是Tab还是Spaces: 4
已存在的 Tab 缩进怎么转成空格？
别用 Ctrl+H 搜 \t 替换，那会误伤字符串、JSON 键名、YAML 对齐等所有位置的制表符。VSCode 提供的 Convert Indentation to Spaces 命令才是唯一安全方式。
- 快捷键：Windows/Linux 按
Shift+Alt+I，macOS 按Shift+Option+I - 命令面板：
Ctrl+Shift+P→ 输入Convert Indentation to Spaces→ 回车 - 必须确保右下角当前显示的是
Tab Size: N或Tab（不是Spaces: N），否则菜单项灰色不可点 - 该命令只处理行首缩进，保留注释、字符串、空行里的
\t，不会破坏语义对齐 - 执行后无法
Ctrl+Z撤销，建议先保存或备份
如何让整个项目统一用 2 空格（如 JS/TS）或 4 空格（如 Python）？
靠全局设置会冲突，靠手动转换太慢。正确路径是语言专属配置 + .editorconfig 双保险。
- 打开命令面板
Ctrl+Shift+P→Preferences: Configure Language Specific Settings→ 选javascript→ 填入：{"editor.tabSize": 2, "editor.insertSpaces": true, "editor.detectIndentation": false} - 同理配
python块，把2换成4；注意语言 ID 必须准确（右下角点一下可确认） - 项目根目录加
.editorconfig文件：[*]\nindent_style = space\nindent_size = 2\n[*.py]\nindent_size = 4
- 关掉
editor.detectIndentation是关键——否则 VSCode 一打开旧文件，就根据第一行缩进自动切回Tab模式，你的设置直接失效
Prettier 或 ESLint 格式化时缩进又乱了？
格式化工具优先级高于编辑器设置，editor.tabSize 在它们面前基本失效。
- 检查项目是否有
.prettierrc或prettier.config.js，确保含：{"useTabs": false, "tabWidth": 2} - 若用 ESLint，禁用其
indent规则，或明确设"indent": ["error", 2]，避免和 Prettier 冲突 - 临时验证：关掉
editor.formatOnSave，手动运行Format Document With...选 Prettier，看右下角是否闪现Formatting with Prettier - 如果
.editorconfig和.prettierrc冲突，Prettier 会以自己配置为准，.editorconfig仅作后备
最常被忽略的一点：语言模式识别错误。比如打开 .jsx 文件，右下角显示 Plain Text，语言专属配置就不生效，退回到未配置的全局行为——这时所有设置都白搭。务必先按 Ctrl+K Ctrl+M 手动指定语言模式。
