VSCode 缩进“乱跳”是因 editor.detectIndentation 自动探测失败——仅扫描文件前几行，遇注释、空行或 tab/空格混用即误判；应禁用该选项并统一配置缩进风格。

为什么 VSCode 缩进会“乱跳”

不是编辑器坏了，而是 editor.detectIndentation 在自动猜缩进风格时出错——它只看文件前几行（甚至第一行非空行），一旦开头有注释、空行或混用 \t 和空格，整份文件的缩进逻辑就崩了。光标跳距异常、按 Tab 键突然插 4 个空格又变 Tab、状态栏右下角缩进标识来回切换（Tab Size: 4 → Spaces: 2），全是这个机制在作祟。

怎么关掉“瞎猜”，强制统一用空格或 Tab

关键不是调单个参数，而是切断探测链：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 在项目根目录建 .vscode/settings.json（不是用户级 settings.json），写入：

  {"editor.detectIndentation": false,"editor.insertSpaces": true,"editor.tabSize": 2}

• "editor.insertSpaces": true 表示按 Tab 键插入空格；设为 false 则插入 \t
• 已有混排文件？先手动点状态栏右下角缩进标识 → Convert Indentation to Spaces（或 to Tabs），再关 detectIndentation，否则下次打开还会误判
• 别信“全局设置已改”——.vscode/settings.json 优先级高于用户设置，且能随 Git 提交，团队直接生效

Prettier / ESLint 格式化后反而更乱？

VSCode 编辑器设置只是“显示层”，真正动手重排的是格式化插件。它们的缩进规则会覆盖编辑器设置，且优先级更高：

• 检查 .prettierrc 或 package.json 中的 tabWidth，必须和 editor.tabSize 一致（比如都是 2）
• 查 ESLint 配置：若用了 @typescript-eslint/indent，确认其 tabWidth 参数没写死成 4
• VSCode 设置里搜 defaultFormatter，确保只启用一个格式化器（如 esbenp.prettier-vscode），禁用其他冲突插件（如 Beautify）
• 临时验证：禁用所有格式化插件，只用原生 Shift+Alt+F，如果此时正常，问题 100% 出在插件配置不一致

怎么一眼揪出隐藏的 Tab 和空格混用

默认状态下 VSCode 不显示这些字符，“对齐”可能是假象：

• 设置中搜 renderWhitespace，设为 "all"：空格变成 ·，Tab 变成 →
• Python 用户尤其注意：混用会直接报 IndentationError；C++/Makefile 中一个隐藏 → 就可能让构建失败
• 执行 Convert Indentation to Spaces 前，务必先 git add -p 或提交当前状态——它会重写整份文件缩进字符，Git 会标记每一行变更
• 粘贴外部代码后缩进错位？大概率源内容带 →，而你当前文件用 ·，把 editor.formatOnPaste 设为 false 能避免自动对齐干扰

最易被忽略的一点：.editorconfig 的优先级高于 VSCode 原生设置，且跨编辑器生效。团队项目建议同步配一份，否则光靠 .vscode/settings.json 还是可能被本地编辑器绕过。