VSCode缩进“突然混乱”主因是editor.detectIndentation误判或格式化插件冲突；应关闭自动探测、统一配置insertSpaces与tabSize，并确保Prettier/ESLint的tabWidth与编辑器一致，同时开启renderWhitespace可视化排查混用。
VSCode代码缩进“突然混乱”，基本不是文件损坏，而是编辑器在某个环节误判或覆盖了你的缩进意图——最常见于打开旧文件、粘贴外部代码、保存触发格式化，或多人协作后混入不同缩进风格的行。关键不是重排一次，而是切断误判源头。
为什么刚打开文件缩进就错位？关掉 editor.detectIndentation
VSCode 默认开启 editor.detectIndentation，它只读文件前几行就决定整份文件的缩进规则。一旦开头有空行、注释或混用 Tab/空格，检测立刻失准，后续所有自动缩进、光标跳转、甚至格式化都会偏移。
- 这不是 bug，是设计行为：它优先“迁就”已有内容，而非执行你设定的规范
- 解决方法不是调低
tabSize，而是在项目根目录建.vscode/settings.json，写入：{"editor.detectIndentation": false,"editor.insertSpaces": true,"editor.tabSize": 4} - 切勿只改用户级设置（
settings.json全局路径），否则新项目仍会复现
粘贴后缩进全崩？禁用 editor.formatOnPaste 并检查 snippet 缩进基准
VSCode 的 snippet 和粘贴逻辑默认按“光标所在行首空白”对齐，不是按语义层级。从 2 空格缩进的函数里粘贴一个为 4 空格写的 log 片段， 占位符就会被硬塞进错误列。
- 临时解法：粘贴前按
Ctrl+Shift+P→ 输入Toggle Render Whitespace，确认目标位置没有隐藏 Tab（→）干扰 - 长期解法：在工作区设置中加
"editor.formatOnPaste": false，避免格式化插件在粘贴瞬间重写缩进 - 自定义 snippet 时，在
body第一行手动加两个空格（或匹配项目tabSize的空格数），比依赖自动推导更可靠
Prettier/ESLint 格式化后反而更乱？核对 tabWidth 是否与编辑器对齐
VSCode 编辑器设置只是基础，真正动手重排的是 Prettier 或 ESLint。如果 prettier.tabWidth 是 2，但 VSCode 的 editor.tabSize 是 4，保存时就会出现“缩进显示为 4 列，但格式化器认为该用 2 列”的撕裂感。
- 查 Prettier 配置：优先看项目根目录的
.prettierrc或package.json中的tabWidth字段 - 查 ESLint：若用了
@typescript-eslint/indent或eslint-config-prettier，确认其tabWidth参数一致 - 验证方式：关掉所有格式化插件，只用 VSCode 原生
Shift+Alt+F，如果此时正常，问题 100% 出在插件配置冲突
怎么一眼看出哪里混用了空格和 Tab？开 editor.renderWhitespace
不打开空白字符可视化，你永远不知道哪行开头是 4 个空格，哪行是 1 个 Tab —— 它们在视觉上完全一样，但 Git diff 会把整行标为变更，Python 会直接报 IndentationError。
- 快捷键
Ctrl+Shift+P→ 输入Toggle Render Whitespace回车，立刻看到 ·（空格）和 →（Tab） - 状态栏右下角显示的
Spaces: 4只代表当前编辑器设置，不代表文件实际内容；混用时这里可能显示正确，但文件里早已藏雷 - 发现混用后，别用查找替换删 Tab：全选 → 右键 →
Convert Indentation to Spaces，这是唯一安全批量修复方式
最易被忽略的一点：HTML、YAML、Makefile 这类文件对缩进零容忍，但 VSCode 语言模式识别常出错——右下角状态栏显示 “Plain Text” 却在编辑 HTML，所有缩进设置都不生效。务必手动点击切换成对应语言模式，再检查设置是否加载。
